The information given in this document is confidential.
SUCH INFORMATION SHALL IN NO EVENT BE REGARDED AS A GUARANTEE OF CONDITIONS OR
CHARACTERISTICS. WITH RESPECT TO ANY VALUES STATED AS "TYPICAL" AS WELL AS EXAMPLES OR
HINTS PROVIDED HEREIN, INCLUDING THOSE RELATED TO USE AND/OR IMPLEMENTATION OR
APPLICATION OF COMPONENTS, LANTIQ DEUTSCHLAND GMBH ("LANTIQ") HEREBY DISCLAIMS ANY
AND ALL WARRANTIES AND LIABILITIES OF ANY KIND, INCLUDING WITHOUT LIMITATION, WARRANTIES
OF NON-INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY. IN PARTICULAR,
THOSE VALUES, EXAMPLES OR HINTS ARE NO WARRANTIES OF A CERTAIN FUNCTIONALITY,
CONDITION OR QUALITY OF THE LANTIQ COMPONENT AND ALWAYS HAVE TO BE VERIFIED IN THE
TARGET APPLICATION.
The information in this document is subject to regular updates and/or corrections via errata sheet(s) or new
revisions. It is only valid as updated and/or corrected. Once a new revision or errata sheet is available, it can be
downloaded from Lantiq's Competence Center:
www.lantiq.com/contact-lantiq
Any user of this document must ensure that they only use the latest update- and/or corrected revision.
LANTIQ HEREBY DISCLAIMS ANY AND ALL WARRANTIES AND LIABILITIES OF ANY KIND, INCLUDING
WITHOUT LIMITATION, WARRANTIES OF NON-INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS
OF ANY THIRD PARTY, WITH RESPECT TO PREVIOUS REVISIONS OF THIS DOCUMENT ONCE AN
UPDATE OR ERRATA SHEET IS AVAILABLE.
Information
For further information on technology, delivery terms and conditions and prices, please contact the nearest Lantiq
office (www.lantiq.com).
Warning
Lantiq components must not be used in life-support devices or systems.
Life-support devices or systems are those systems intended to be implanted in the human body or to support
and/or maintain and sustain and/or protect human life. If they fail, it is reasonable to assume that the health of the
user or other persons may be endangered.
Page 3
DUT Graphical User Interface
DUT Tool Package
Confidential
XWAY™ xRX300/WAVE300 Family, DUT Graphical User Interface for DUT Tool Package
Confidential
Revision History: Revision 1.1, 2013-05-06
ARM™, Bluetooth™ of Bluetooth SIG Inc. CAT-iq™ of DECT Forum.
EPCOS™ of Epcos AG.
HYPERTERMINAL™ of Hilgraeve Incorporated. IEC™ of Commission Electrotechnique Internationale. IrDA™ of
Infrared Data Association Corporation. ISO™ of INTERNATIONAL ORGANIZATION FOR STANDARDIZATION.
MATLAB™ of MathWorks, Inc. NUCLEUS™ of Mentor Graphics Corporation. MIPS
USA. muRata™ of MURATA MANUFACTURING CO. SOLARIS™ of Sun Microsystems, Inc. Samtec
®
of MIPS Technologies, Inc.,
®
of Samtec
Inc. TEAKLITE™ of CEVA, Inc. TEKTRONIX™ of Tektronix Inc. UNIX™ of X/Open Company Limited.
VERILOG™, PALLADIUM™ of Cadence Design Systems, Inc. VxWorks™, WIND RIVER™ of WIND RIVER
SYSTEMS.
This user guide explains how to use the DUT GUI application. The application is used for hardware development
purposes and evaluations based on Lantiq's WiFi MIMO technology.
1.2About the Test Driver and the DUT GUI Application
The DUT GUI is an application used to help hardware and RF designers test and verify the behavior of their design
based on Lantiq's WiFi solution.
DUT GUI uses a specially designed test driver with the firmware that uses all HW and PHY level algorithms. The
driver also allows transmission and receiving without the limitations of the IEEE 802.11n standard
The DUT GUI includes an API to control the WiFi functionality (mt_dut.dll). The API can be used to control the DUT
(Device Under Test) from an external application.
Together with wireless LAN test equipment maker LitePoint, Lantiq have integrated this dll into LitePoint's IQFact
Design Verification Test (DVT) software. IQFact is a comprehensive set of WiFi physical layer transmitter and
receiver tests utilizing a large set of channels, data rates and channel bandwidths. The tool allows you to verify
assembly in the production line with a vast test coverage in a short test time
[4].
1.3Content of the Installation Kit
The installation package for the DUT GUI installs the following items onto your computer:
•DUT GUI Core
•ActivePerl application - Perl interpreter (used for TCP/IP mode)
•Release Notes [5]
•User’s Guide (= this document)
Note: Contact Lantiq for the latest application version and installation instructions.
1.4Supported Interfaces
The DUT GUI application allows you to control the WiFi chipset through the following interface:
•TCP/IP - Control the chipset when it is assembled on a Linux based host. In order for the DUT GUI to work,
the host should contain operational driver firmware. The following Host and Linux versions are supported:
•Lantiq's Universal Gateway (UGW) software
1.5x86 PC Linux Host Requirements
The DUT system provides following requirements to the x86 Linux host in order to operate properly:
1. Microsoft® Windows® XP SP 3.0 and .NET Framework 2.0 (min. requirement)
2. Support for Microsoft® Windows® 7, 32/64 bit
3. OS login/password required is root/wlan
4. This may be changed by editing the linux_hosts.txt file in the DUT's installation directory, with a new
username/password to be specified in its [PC] section.
5. Tftp client package must be installed.
User’s Guide8Revision 1.1, 2013-05-06
Page 9
DUT Graphical User Interface
DUT Tool Package
Confidential
2Installing DUT GUI
To install DUT GUI:
1. From the installation me
The DUT Installation window appears.
dia, DUT_setupx.exe.
Installing DUT GUI
Figure 1DUT Installation Welcome Screen
Note: Components required for the installat
2. Ensure the correct elements are selected and click Install.
If an older version is already installed on the computer, you
proceeding.
In C:\Program Files\Lantiq\D
•DUT_GUI.exe - GUI application
•dut_cfg.txt - Configuration file to determine the output powe
operation and basic platform configurations.
•\autoloader\linux_hosts.txt - configuration file that
•Regulatory Constraints Folder - Contains inform
•Developers Folder - Contains XXX.h files for integrating dut.dll in other applications
•DUT GUI User Guide.
Other:
•The log for the DUT GUI application, console.txt
•A shortcut to DUT_GUI.exe is created on your desktop
User’s Guide9Revision 1.1, 2013-05-06
UT\
ion/upgrade are automatically selected.
will be prompted to remove the older version before
r level desired during close loop transmission
defines the login and password for the platform
ation for using regulatory constraints mode
, is created in the My Documents folder
Page 10
DUT Graphical User Interface
DUT Tool Package
Confidential
Launching DUT GUI
3Launching DUT GUI
To launch the DUT GUI application:
1. From the desktop, double click the DUT GUI shortcut.
2. Optionally, change the “dut_cfg.txt Configuration Parameters” on Page 15.
The application tries to connect to the DUT.
•If the DUT was pre-configured for the proper paramete
displayed.
•If the connection is not successful, an er
parameters and information are correct. For more information on how to troubleshoot an unsuccessful launch,
see “Troubleshooting Launch Errors” on Page 11.
Main screen of the DUT GUI follow
ing a successful launch:
ror message appears. In this case make sure that the proper
rs, the connection succeeds and a ready message is
Figure 2DUT GUI Main Screen (Successful Launch)
Note: Please pay attention to the “Ready” message in the messages pane.
User’s Guide10Revision 1.1, 2013-05-06
Page 11
DUT Graphical User Interface
DUT Tool Package
Confidential
Launching DUT GUI
3.1Troubleshooting Launch Errors
Table 1Typical Launch Errors and Solutions
Possible Cause of Failure Solution
External power supply is not turned on.Close the DUT GUI.
Enter DUT into the host.
Turn on the power supply.
Run the application again.
For a Linux based host, the IP might not be correct.Verify that the IP address is correct and the PC's Ethernet
d is properly configured.
car
Restart the host.
Another application (IQFact, D
test driver.
Wrong dut_cfg.txt configuration file parameters are
chosen
Wrong Band and channel are configured on initial
usag
.
e
UT GUI) is using the
After approximately 1 minute, p
Close the DUT GUI.
Reboot the DUT.
After the DUT is up, restart the DUT GUI application.
Choose the correct HW type and version according to the
platform type.
Make sure that Wlan index in properly selected in case of
du
al band concurrent platform.
Insert appropriate Band/Channel and press the reconnect
button
ress the reconnect button.
An example of the main screen of the DUT GUI f
ollowing an unsuccessful connection:
Figure 3Main Screen of DUT GUI Application after an Unsuccessful Launch
User’s Guide11Revision 1.1, 2013-05-06
Page 12
DUT Graphical User Interface
DUT Tool Package
Confidential
Note: Please pay attention to the “There is no ping reply” message in the messages pane.
Figure 4DUT DLL Log
Note: Please pay attention to the “No ping reply from host” message in the log pane.
Launching DUT GUI
User’s Guide12Revision 1.1, 2013-05-06
Page 13
DUT Graphical User Interface
DUT Tool Package
Confidential
4Overview of the DUT GUI
The DUT GUI provides the following functions:
4.1DUT GUI Features
•Change DUT operation to desired channel
•Turn on/off Rx/Tx antennas
•Receive 802.11a/b/g/n packets
•Transmit 802.11a/b/g/n packets in nCB/CB Mode and at SISO/MIMO rates
•Transmit in Open/Closed loop with Regulatory
•Read and burn the EEPROM/Flash
•Crystal frequency tuning tool
4.2The Tab Bar
The DUT GUI includes five tabs:
•Basic Operation - Includes all functions needed to contr
•Extended operation - Includes calibration of the on-boar
•EEPROM & Statistics - Includes all functions needed to read
advance options
•TPC - Includes specific calibration
•INFO - Includes information about current system sta
in nCB/CB Mode and at SISO/MIMO rates
restrictions
ol the receiving and transmission for the DUT
d Crystal and an option for future Antenna selection
and write to the EEPROM along with some
data information represented in the EEPROM/Flash
te, such as power-up self test results
Overview of the DUT GUI
Figure 5DUT GUI Tabs
4.3Log and Messages Pane
Figure 6Log and Messages Pane
In the log pane, you can see the status of command execution. Problems are colored in red.
User’s Guide13Revision 1.1, 2013-05-06
Page 14
DUT Graphical User Interface
DUT Tool Package
Confidential
4.4Calibration Data Screen
Overview of the DUT GUI
Figure 7Calibration Data Screen
During production testing, TX p
The Calibration Data screen includes
calibration.
The information displayed is for debugging purposes only.
ower calibration is performed for enabling closed loop transmission.
the information from the EEPROM which was collected during the
User’s Guide14Revision 1.1, 2013-05-06
Page 15
DUT Graphical User Interface
DUT Tool Package
Confidential
Using the DUT GUI
5Using the DUT GUI
5.1Connection Options
On the Basic Operation tab, the connection options are shown. Target IP should be provided. Reconnect and
reboot buttons are available.
Wlan card 0 or 1 can be selected by pressing the desired radio button.
5.1.1dut_cfg.txt Configuration Parameters
Before starting the connection, specific parameters should be checked in dut_cfg.txt file located in C:\Program
Files\Lantiq\DUT
Reset Hardware Information
Reset_HW_Type0 = 64//Wlan0 HW type (decimal value)
Reset_HW_Type1
Reset_HW_Revision0 = D //Wlan0 HW revision (decimal value)
Reset_HW_Revision1 = B //Wlan1 HW revision (decimal value)
= 49 //Wlan1 HW type (decimal value)
Set here the HW type and revision of
order to load the correct progmodels. DUT supports two hardware types for supporting Dual band concurrent
platforms.
Default WLAN index (0/1)
Default_WLAN_Index = 0 // Two Wlan units are supported 0 or 1
This value defines DEFAULT WLAN and may be overridden by Dut_SetWLANindex API call or Wlan card Wlan0
or
Wlan1 radio buttons in DUT GUI.
Crystal Frequency Tuning
ENABLE_XTAL_CALIB = 1
1-Read XTAL tuning value
0-XTAL calibration is disabled
XTAL_CAL_BIAS = 0 // Siward is the default (76)
This is the value of the XTAL bias (7 msb of the register).
The following XTAL Bias values are supported:
from EEPROM/Flash and enable XTAL calibration
your card. When the EEPROM/Flash is empty, DUT will use those values in
Table 2XTAL Bias Values
XTAL VendorXTAL TypeXTAL_CAL_BIAS decimal value
nnel according to the last run. You can select different
o depends on the type of packets the DUT will
User’s Guide16Revision 1.1, 2013-05-06
Page 17
DUT Graphical User Interface
DUT Tool Package
Confidential
If CB is used, the selected channel is the primary channel and you need to choose if the secondary channel will
be on the lower or upper side of the primary channel. The DUT GUI automatically calculates the actual frequency
of the DUT's LO according to the channel, the BW, and the location of the secondary channel
Figure 9Example of Primary and Secondary Channel Selection in CB Mode
•Signal BW - When the 40Mhz spectrum BW is chosen, you can choose between CB (40 MHz) Tx or SSB
gle side band) transmission.
(sin
– In SSB mode, all Tx and Rx filters are on 40 MHz BW, LO is according to 40 MHz transmission but the actual
tra
nsmitted signal is only in one side of the LO (according to the location of the primary channel)
– The difference from the previous option of 20MHz is th
the filters used.
•Channel - Select a channel according
automatically be calculated according to BW definitions.
•Byte length - The packet length in bytes. The maximum length is 1570 bytes.
•Rate index - According to the MCS tab
indexes will be according to the protocol type chosen.
•Calibration mask - This influences the
should be set to 0xFFFF.
•Repetitions - How many times the packet should be transmitted.
Note: 0xFFFF (65535 in Decimal) = endless transmission
to the 802.11n standard definition of channel. LO Frequency will
le at the 802.11a/b/g/n standards [1]/[2]/[3]/[4]. The list of available rate
initial calibration inside the RF chip after setting channel. The value
e location of the signal in comparison to the LO and
Using the DUT GUI
•Set Channel button - To instruct the DUT
– a.Set all the parameters.
– b.Click Set Channel.
When changing channel all trans
•Transmit button - To instruct the DUT to start transmitting:
– a.Set all the parameters.
– b.Click Transmit.
•Stop Transmission button - Use this to instruc
Transmit mode).
to change channel:
missions will be stopped.
t the DUT to stop transmitting (only available when DUT is in
5.3Setting Output Power
Figure 10Open Loop Tx Setting
User’s Guide17Revision 1.1, 2013-05-06
Page 18
DUT Graphical User Interface
DUT Tool Package
Confidential
When transmission is used, you can select several standard and special configurations:
•Set TPC - This option is only available in o
Channel” on Page 16.
TPC is one of the gain controls of the RF ch
greater than 2 will lower the output power. The maximum value for TPC is 30 (lowest power). You can decide
whether to apply the same TPC value to both transmitters or set independent values for each transmitter.
The output power in open loop mode can be changed before or during transmission.
pen loop (see Calibration Mask details in “Setting the DUT's
ip. Enter 1, to select transmission with the highest power, any number
Using the DUT GUI
5.4Closed Loop Output Power Table
Figure 11Closed Loop Tx Setting
•Set Tx power - In a closed loop transmission (see Calibration Mask details in “Setting the DUT's Channel”
on Page 16, power is set automatically using pre-calibrated
information is stored in the EEPROM/flash during the TPC calibration method implemented by Litepoint's
IQFa
ct application.
•The Tx output power is configured automatically according to the rate (see tables below).
•Output power in closed loop can be changed before or during transmission.
•Close loop power can be set in 1/8 dB resolution example 16.125 dBm, 16.875 dBm etc.
•Power table according to the rate is found and can be adjusted in the
C:\Program Files\Lantiq\DUT.
•There are two options to set the default power per ra
parameter option in the dut_cfg.txt file: Constant Power and “Back Off Power” on Page 19.
te. Both are configured using the Use_TPC_Power
information stored in the EERPOM/flash. The
file: dut_cfg.txt which is located in
5.4.1Constant Power
Use_TPC_Power = 0
Power is determined according to the following
Note: For 802.11n [4], rates 8-15 have the same power as rates 0-7.
User’s Guide18Revision 1.1, 2013-05-06
Page 19
DUT Graphical User Interface
DUT Tool Package
Confidential
Using the DUT GUI
5.4.2Back Off Power
Back off power from Max power in the EEPROM
Use_TPC_Power = 1
Power is determined according to the maximum power stored in the EEPROM minus the following back off. The
5.5Using Regulatory Constraints in Closed Loop Tx Mode
Figure 12Regulatory Constraints in Closed Loop Tx Mode
For EMI testing, there is an option to limit the tra
To use this mode:
1. Consider the regulatory (see“Regulatory Limitations” on Page 19) and hardware (see “Hardware
Limitations” on Page 20) limitations.
2. Select the Use regulatory constraints mode.
nsmitted power according to the EMI standards.
5.5.1Regulatory Limitations
Regulatory limitations are imposed by the ETSI, FCC, and Telec standards for different channels and BW.
The reglimits.csv file is provided (in C:\Pr
and Telec limitation for all the channels. The DUT GUI uses the information in this table to define the max output
power allowed for each of the bands and frequencies. An example is shown in the following table.
The hardware limitation are different for every type of board. During EMI certification, for example, an RF board
might need to lower the output power even more than required in the regulation for the specific channel used
because of band edge, 2nd harmonic and other limitations.
The DUT GUI uses information from the supplied
information found in the EEPROM during startup. All known HW types are listed at the top of the ini file.
limits.ini file according to the HW Type and HW Version
If there is no HW limit for the HW used in the spec
DUT GUI will not allow users to change the des
After the desired power is changed, click Set power for the change to take effect.
ific channel, only the regulatory limits will be taken into account.
ired Tx power value more than the limitation described above allow.
5.6Changing BB and PA Driver Gains
Figure 13BB and PA Driver Gain Setting
The DUT GUI allows you to control the TPC attenuator in the
amplifiers:
•Base band gain (BB gain) - In the BB side of the RF chip ther
•PA driver gain - In the RF side of the RF chip there is an option to gain 0 or 3 dB using the PA driver gain control
The system automatically determines the
bands.
Note: This Gain change option is applicable for XWAY™ WAVE300 devices only.
initial value of both gains and this might differ between frequencies and
RF chip and two additional RF chip internal
e is an option to boost dB gain by 0, 2.5, or 5
User’s Guide20Revision 1.1, 2013-05-06
Page 21
DUT Graphical User Interface
DUT Tool Package
Confidential
Using the DUT GUI
5.7Transmitting in CW Mode and Changing IFS Section
Figure 14Transmitting in CW Mode and Changing IFS Section
•CW mode - To set the DUT to transmit in CW mode, define the CW
the transmission, click Stop CW.
Note: The amplitude is just an index and is not in dBm. The
•Changing spacing - To change the IFS (inter frame spacing
Between Packets. When changing the spacing, Rx Antennas are closed to verify that the IFS isn't determined
also because of received packets for different 802.11 station in the area.
•Space-less transmission - When this mode is selected, the trans
there will be no idle time - 100% Duty cycle. This is not a standard mode of operation and some time is required
for certification testing.
higher the index used, the higher the CW's amplitude.
), set the spacing in µSec and click Set Spacing
amplitude and click Transmit CW. To stop
mission coming out will be continual, meaning
5.8Setting Antenna Configuration
Figure 15Antenna On/Off Section
Lantiq's WiFi solution includes three tran
antenna by clicking the relevant button as shown above.
smit and three receive antenna. You can turn off one or more of the
User’s Guide21Revision 1.1, 2013-05-06
Page 22
DUT Graphical User Interface
DUT Tool Package
Confidential
Using the DUT GUI
5.9Rx Information and PA Detector Information
Figure 16RSSI, Packets Counter and PA Detector Information
When you click Update, the following are read from the DUT:
•RSSI values (signal strength) for each of the three Rx antennas (in dBm)
•Packets received counters (PHY level) - There are two readings:
– the upper is for the number of packet received in the modem
– the lower is for the number of packets received in the modem with CRC error.
•Packets received counter (MAC) - This counter is not used.
•PA voltage - Returns the power indication from t
The PA detector information enters the BB chip through an 8
of several readings and the numbers are on a scale of 0-255. Usually, each step represents approximately 10 mV.
he PA detector during transmissions.
bit A/D. The reading in the DUT GUI is an average
5.10Chip Gain Information
Figure 17Chip Gain Information
When you click Update Gains, the following are read from the DUT:
•RF LNA Gain
•RF Mixer Gain
•BB Gain
Note: The gain information
is applicable for XWAY™ WAVE300 devices only.
User’s Guide22Revision 1.1, 2013-05-06
Page 23
DUT Graphical User Interface
DUT Tool Package
Confidential
5.11DUT and Chip Versions
Figure 18Version Information
During startup, the DUT GUI reads the RF and BB chip versio
displays it together with the DUT GUI application version.
The RF chip version 0x30 indicates XWAY™ WAVE300 (PSB 8301, PSB 8304) RFIC
The BB chip version 0x710 indicates XWAY™ WAVE300 (PSB 8221, PSB 8231) BBIC
ns from the relevant HW registers in the chips and
5.12Reading and Writing the EEPROM/Flash
Using the DUT GUI
5.12.1Configuring EEPROM/Flash Area Size
EEPROM/Flash area size may be configured via dut_cfg.txt file.
It is possible to specify EEPROM/Flash area size
default value is 1024 bytes.
in bytes by the means of parameter EEPROM_Size_Bytes. The
5.12.2Burning a File to EEPROM/Flash
Figure 19EEPROM/Flash Burning Section
The EEPROM/Flash contains important information
•PCI information (including Vendor ID and Device ID).
•HW Type and HW version information - To determ
•TPC calibration information.
Attention: A module will not work
mentioned above.
without correct values in the EEPROM/Flash for all three areas
for operation of the module. The information includes:
ine which firmware to load to the module.
The EEPROM/Flash is usually burned only once, during the production
EEPROM/Flash consists of a text file in the following form:
<Address><data>
User’s Guide23Revision 1.1, 2013-05-06
testing. Information burned into the
Page 24
DUT Graphical User Interface
DUT Tool Package
Confidential
Example:
0000FC1B
0002
00040000
00060100
Attention: Burning the wrong information into the EEPROM/Flash can cause the module to stop working
without the
CD00
possibility to reverse the damage.
Using the DUT GUI
5.12.3Working with Serial Numbers and MAC Addresses
Figure 20MAC Address and S/N Information R/W
The EEPROM/Flash includes MAC
testing and assembly.
Using the DUT GUI, the following information can
•MAC address - is in 12 hexadecimal digits
•Serial number can be in 2 following
•YYWWMMNNNNNCC where
– YY - Year of manufacture
– WW - Week of manufacture
– MM - Two letter initials of assembly house (this information
– NNNNN - Five digits of sequential serial number
– CC (optional) - Short country name (two-letters), as liste
domain limitations.
– For full country code list see Appendix C - Country Codes
Example: 0
•KKKKKYMNEXXXXXX
– KKKKK - 5 digits of module name.
User’s Guide24Revision 1.1, 2013-05-06
825ML12345US
address, country code and serial number information burned in the production
be read from the EEPROM/Flash:
formats
is not stored in the EEPROM/Flash)
d in the 'Country' drop list, used for regulatory
Page 25
DUT Graphical User Interface
DUT Tool Package
Confidential
– Y - Year of manufacture
– M - Month of manufacture (A=October, B=November, C= December)
– N - board revision
– E - Regulatory domain (Example: E= ETSI)
– XXXXXX- Five digits of sequential serial number
Example: AN66085NE123456
The following options are available in this section:
•Read EEPROM/Flash Information - Read current S/N, country code and MAC address information from the
EEPROM/Flash
•Burn Barcode and MAC address - Write the S/N (barcode) and MAC address information provided by the
user to the EEPROM/Flash
•Set temporary - Give the module a temporary MAC address. This MAC address will not be saved into the
EEPROM/Flash but can be used to filter received packets without this MAC address.
•Burn Country Code - Write the chosen country code to the EEPROM/Flash.
The Rx packets counter for packets received with this MAC address can be found in the first tab of the application
in the “Rx information” section.
Using the DUT GUI
User’s Guide25Revision 1.1, 2013-05-06
Page 26
DUT Graphical User Interface
DUT Tool Package
Confidential
5.12.4Changing Raw Content
To view EEPROM/Flash raw data:
1. From the third tab, click View / Change/ Save EEPROM…
The following screen appears.
Using the DUT GUI
Figure 21EEPROM/Flash Raw Data
The information is shown as two hexadecimal digits for each
digits). For example, 1Ah (equivalent to 0x1A).
To edit the EEPROM/Flash raw data:
1. Clear the View Only Mode checkbox.
2. Edit the EEPROM/Flash conten
Burning is performed when the cursor moves from the changed cell
3. To save all the EEPROM/Flash
The file can be loaded with the
User’s Guide26Revision 1.1, 2013-05-06
t for each cell separately.
content to a file, click Save to text/binary file.
“burning EEPROM file” function in the second application tab
address (hexadecimal marked by the 'h' after the two
Page 27
DUT Graphical User Interface
DUT Tool Package
Confidential
5.13XTAL Calibration
This form can be found in the Extended operation tab.
Using the DUT GUI
Figure 22XTAL Calibration
Two XTAL configuration fields are available:
•XTAL Value - tuning value register
•XTAL Bias - drive strength value (the XTAL Bias
These fields can be read and written to the RFIC and EEPROM/Flash
The following XTAL Bias values are supported:
Table 6XTAL Bias Values
XTAL VendorXTAL TypeXTAL_CAL_BIAS decimal value
•If a function is used to receive information (counter etc.) the value will be returned
•In all other cases, the function will return “1” for success or “0” for fail
Parameters for all functions have names as defined in the header file “DUT_API.h”. For example:
#define DUT_MODE_B 1
#define DUT_MODE_N 2
6.1Init Process
Dut_SetConnectionMode(int connectionType, const char* optIPaddr);
// Set the connection mode to the device. 0=PCI, 1=UART,2=SPI,3=LINUX.
IP addr should be specified for linux connections, can be null otherwise This
function should be called BEFORE Dut_DriverInit.
Int Dut_DriverInit(void) // Return 1 after success
Int Dut_DriverVersion(double *version); // returns the version to the location of
the pointer
Int Dut_SetWLANindex(int wlanIndex);
// In case of concurrent dual-band board, use this function before connection or
reconnection in order to choose the needed WLAN card index - 0 or 1, where 0 is the
default. Call this function AFTER calling Dut_SetConnectionMode
Dut_BistRes(int* BistRes); //Reads results of the BIST
6.2Calibration Process and Tx Tests
Int Dut_SetChannel(int Mode, int band, int CBMode, int channel, BYTE CalibrationMask)
// mode={a,b,g,n}, Band={2400,5000}, CBMode={20,40} channel_index (not the actual
frequency) CalibrationMask - in Hexadecimal
Int Dut_ChangeScramblerMode(int mode) // {0 ,1}
Int Dut_SetTPC (int TPC) // {25,..,2}
Int Dut_TxPackets (int Mode, int RateIndex, , int CBMode, int Length, int
repetitions) // mode={a,b,g,n}, rate={MSC table}, CBMode={20,40}, length in byte,
repetitions - number of packets or 0xFFFF for endless transmission.
Int Dut_EndTxPackets (Void)
Int Dut_ReadVoltageValue (double* voltages) // Returns the power values in Volts for
both Tx antennas to the pointer of the value array.
User’s Guide28Revision 1.1, 2013-05-06
Page 29
DUT Graphical User Interface
DUT Tool Package
Confidential
Int Dut_SetPower(int power); // Sets the Tx power for close loop only. The value is
the desired Tx power per antenna in dBm. The function itself does not change the
power: you must call this function before calling Dut_TxPackets.
Int Dut_SetPowerFloat(float power); // The float version can received more accurate
values (in *1/8db)
Available Functions in mt_dut.dll
6.3Burning the EEPROM
Int Dut_BurnEEPROM (DWORD Address, DWORD length, const BYTE* value) // Burning
information into the EEPROM.
•The address is in hexadecimal.
•The length is in bytes.
•The value is the string in hexadecimal.
Examples:
Int Dut_ReadEEPROM (DWORD address, DWORD length,BYTE* data); // Read data from the
EEPROM, at a specified address. Length is the number of bytes.
Int Dut_Burn_MAC_Address (const BYTE *mac_address) // Used to burn the MAC address
(length of 6 bytes).
Int Dut_Burn_Date (int year, int week) // Used to burn the date of the mPCI
production.
Int Dut_Burn_SN (DWORD SN) // Used to burn the S/N (3 Bytes)
Int Dut_Burn_File (const char* filename) // Used to burn file with address and
information to the EEPROM. The file should be in the form of:
<Address> <Data>
Example:
0040 AAFF
Dut_Burn_File can also be called instead of Dut_DriverInit, which in this the file will be burned before the
init process first reads the EEPROM.
Int Dut_BurnInfo(const char* barcode, const BYTE* macAddr, const char* filename) //
One function that burns the S/N from the barcode, the MAC address, and the EEPROM
file.
Int Dut_Burn_Cal_Data (const Dut_CalDataStruct* pCarStr) // Used to burn the
calibration data. The structure is in the form of:
User’s Guide29Revision 1.1, 2013-05-06
Page 30
DUT Graphical User Interface
DUT Tool Package
Confidential
Available Functions in mt_dut.dll
Figure 23Burn Calibration Structure
6.4EEPROM Burning New Calibration Method Function
extern MT_RET PASCAL Dut_EEPROM3_Burn_Cal_Data(const Dut_CalDataStruct3*
inCalArray, Dut_CalDataStruct3* outCalArray, int numStructures);
// Burn calibration data using the Dut_CalDataStruct3 for EEPROM Version 3 (defined
// above)
// int numStructurs - # of Dut_AntCalDataStruct3 structures in calArray (2.4 + 5 GHz)
// outCalArray is an optional parameter (can be NULL). If specified, the function
// fills the outCalArray with the linear correlation (LR) results.
// You can use the function Dut_EEPROM3_Test_Cal_Data to verify the LR results for
// part or all of the structures before burning.
extern MT_RET PASCAL Dut_EEPROM3_Test_Cal_Data(const Dut_CalDataStruct3*
inCalArray, Dut_CalDataStruct3* outCalArray, int numStructures);
// Same as Dut_EEPROM3_Burn_Cal_Data but without burning to the EEPROM.
6.5Sensitivity Check
Int Dut_SetMACAddress(const BYTE* macAddr);
// Sets the MAC address for the testing procedure. Does NOT burn to EEPROM. macAddr
is a BYTE[6] array. This function can and should be called before the call to
Dut_DriverInit(). It sets the Rx filter in the lower Mac for packets only in this
MAC address.
Int Dut_SetRxAntenna(int rx_antenna_mask);
User’s Guide30Revision 1.1, 2013-05-06
Page 31
DUT Graphical User Interface
DUT Tool Package
Confidential
// options = {001, 010, 100, 011, 101, 110, 111}. Returns 1 following a success.
Int Dut_PHYPacketsCounter (unsigned int* packetsCounters)
// Returns the current value of the received packet counter and CRC error counter.
Read before and after transmission. Values will be returned in decimal to the
location of the array. The array should be composed of two values of uint type. The
first is for the packet counter and the second is for the CRC error counter. This
function returns the counters from the PHY layer and does not filter packets
according to MAC address.
Int Dut_MACPacketsCounter (unsigned int* packetsCounters)
// As above, but returns the counter from the lower MAC level. Packets are filtered
according to the MAC address set in the MAC (by using the function Dut_SetMACAddress.
Int Dut_ResetPacketsCounter ()
// Resets the packets and CRC error counters.
Int Dut_RSSIVector (double* RSSI) // Returns the RSSI value of three Rx antennas at
the time of the call to the location of the array. The array should be composed of
3 values of double type. Values are in dBm.
Available Functions in mt_dut.dll
6.6Finalize the Test
Int Dut_DriverRelease(void);
// Used to terminate your driver control when you have allocated some resources, e.g.
memory. Can be just a dummy return if your driver has nothing to release.
6.7Others
Int Dut_WriteReg(DWORD address, DWORD Data, DWORD mask); // For the BB chip
Int Dut_ReadReg(DWORD address, DWORD* pData, DWORD mask); // For the BB chip
Int Dut_ReadRFReg(DWORD address, DWORD* pData, DWORD mask); // For the RF chip
Int Dut_WriteRFReg(DWORD address, DWORD data, DWORD mask); // For the RF chip
Int Dut_ReadChipVersion(DWORF* RF_chip_version, DWORD* BB_chip_version)
Int Dut_ChangeRFChipMode(DWORD mode);
// Changes the mode of operation of the RF chip. In all modes which are not listen,
the gen risc is disabled. To re-enable, you must return to listen mode.
Possible options are:
#define DUT_RF_MODE_LISTEN 0xF77 // Tx turned off
#define DUT_RF_MODE_STANDBY 0x800 // Only LO is kept on
#define DUT_RF_MODE_POWERDOWN 0
User’s Guide31Revision 1.1, 2013-05-06
Page 32
DUT Graphical User Interface
DUT Tool Package
Confidential
Int Dut_ReadRFGain(BYTE* RF_Gain_Values); // Read RF Gain - RF_Gain_Values must be
an array of 6 bytes with:
0 - RX0_LNA_Gain
1 - RX0_MIXER_GAIN_6DB
2 - RX1_LNA_Gain
3 - RX1_MIXER_GAIN_6DB
4 - RX2_LNA_Gain
5 - RX2_MIXER_GAIN_6DB
Int Dut_ReadBBGain(int* BB_Gain_Values); // Read BB Gain - BB_Gain_Values must be an
array of three integers for each antenna - returns total of LPF1+LPF2+VGA in db
Int Dut_ReadDetector(BYTE* detector_values); // Read Detector - detector_values must
be an array of four bytes:
0 - PLL_Lock
1 - THD0 (Threshold detector RX0 output)
2 - THD1 (Threshold detector RX1 output)
3.- THD2 (Threshold detector RX2 output)
"Int Dut_ReadVoltageValueEx(double* pVoltage, int numSamples) // Same as
ReadVoltageValue, numSamples - # of samples for each antenna for averaging. Default
value for numSamples (used in Dut_ReadVoltageValue) function is 35
Available Functions in mt_dut.dll
Tx Gains Set/Get for each TX antenna:
Int Dut_SetTxGains(int* bbGains, int* driverGains);
Int Dut_GetTxGains(int* bbGains, int* driverGains);
// Parameters:
// bbGains - array of 2 ints (for each TX ant). Each value can be 0 for 0[db], 1 for
2.5[db] and 2 for 5[db]
// driverGains - array of 2 ints (for each TX ant). Each value can be 0 (Low) or 1
(High)
Dut_StopRISC() // Stops the GenRISC processor (PHY)
Dut_StartRISC() // Starts the GenRISC processor (PHY)
User’s Guide32Revision 1.1, 2013-05-06
Page 33
DUT Graphical User Interface
DUT Tool Package
Confidential
Appendix A - PCI EEPROM Address Map
7Appendix A - PCI EEPROM Address Map
The eeprom structure includes four major sections:
1. Executive control Region (00-04h)
The first two words are the eeprom signature. The signature is a known number which indicates valid eeprom
infor
mation (e.g. not empty).
2. PCI spec RunTime registers (05-0Bh)
These registers are the PCI configuration registers which must be in an
combination of the CIS (see section 4), define the HW installed at the PCI bus. This region is restricted for PCI
HW definition native needs.
3. RunTime registers - (0C-3Fh)
These registers are used as default co
Initiator and targe
address.
4. Initialization section - (40-F8h)
This section is used to save initialization
calibration data and other Metlalink's native information.
Table 7EEPROM Address Map
DataAddress
Header 0x40-0x47
HW configuration Sub Section type 0x48
HW configuration Sub Section length0x49
HW type0x4A
HW revision0x4B
Country code (for Regulation domain) See APPENDIX F
for full country
BB chip ID0x4D
RF chip ID0x4E
MAC address0x4F-0x54
Serial number0x55-0x57
Week and Year0x58-0x59
TPC Calibration data
TPC Calibration data
TPC Calibration data0x5C - 0xF8
t HW. It includes Device and Vendor Id, shared RAM address and configuration space
code list
Sub Section type 0x5A
Sub Section length0x5B
nfiguration for the PCI
parameters as Card type and version, MAC address, serial number,
0x4C
y PCI device. These registers with
Note: Modification of all sections off th
User’s Guide33Revision 1.1, 2013-05-06
e EEPROM is forbidden and could result in initialization failure.
Page 34
DUT Graphical User Interface
DUT Tool Package
Confidential
Appendix B - Example Code for mt_dut.dll Usage
8Appendix B - Example Code for mt_dut.dll Usage
Use the mt_dut.dll to develop automatic applications to control the DUT. The following files are available to you
(in C:\Program Files\Lantiq\DUT\Developers):
•dut_api.h
•mt_types.h
•MT_DUT.lib
Example code:
This C source code defines the functions used by the supplied command line demo
application.
The Dut_XXX functions are declared in the supplied dut_api.h according to the
specifications, and you can also use the supplied MT_DUT.LIB for easier access to
the MT_DUT.DLL.
#include "../dut_api.h" // Set to your path of the dut_api.h file
#include <stdio.h>
#include <stdlib.h>
/// Prints the API error in case ret is MT_RET_FAIL
int TryRunning(int ret)
{
if (ret == MT_RET_FAIL) printf("%s\n", Dut_GetLastError());
return ret;
}
/// Prints the driver or API version
int DriverVersion()
{
double version;
Dut_DriverVersion(&version);
printf("Driver version: %.2f\n", version);
return MT_RET_OK;
}
// Initialize the driver (in our command line application, it is called
automatically)
int DriverInit()
{
return TryRunning(Dut_DriverInit());
}
// Releases the driver, and exits the application
int DriverRelease()
{
if (!TryRunning(Dut_DriverRelease())) return MT_RET_FAIL;
exit(MT_RET_OK);
return MT_RET_OK;
}
User’s Guide34Revision 1.1, 2013-05-06
Page 35
DUT Graphical User Interface
DUT Tool Package
Confidential
int SetChannel(int Mode, int band, int BW, int channel, BYTE calibrationMask)
{
During the DUT GUI installation, the DUT_BCL command line application is also installed.
The application enables 3 options for control of the Platform (all information can be seen with -
•Opening a dedicated command window application
Syntex: DUT_BCL.
•Providing direct commands (one command at a time)
Syntax: DUT_BCL.
syntax>
•Running a script file wit
Syntax: DUT_BCL.
1. Run the tool from C:\Program Files\Lantiq\DUT\DUT_BCL.exe.
The cmd window appears (Figure 24).
BBICBaseband Integrated Circuit
BPFBand Pass Filter
BSSThe Basic Service Set (BSS) is the basic building block of a wireless LAN. Coverage of one
access point is called a BSS. An access point acts as a master to control the stations within
that BSS. Each BSS is identified by an SSID.
C
CBChannel Bonding (40 MHz transmission)
CLICommand Line Interface
D
DUTDevice Under Test
E
ERPExtended Rate Policy
ESSIDExtended Service Set Identifier
I
IOCTLSInput/output controls - typically employed to allow userspace code to communicate with
hardware devices
L
LDPCLow-Density Parity-Check code (LDPC code) - An error correcting code. A method of
transmitting a message over a noisy transmission channel.
M
MIMOMultiple-Input and Multiple-Output - The use of multiple antennas at both the transmitter and
receiver to improve communication performance. One of several forms of smart antenna
technology.
mPCIMini PCI - A bus standard for attaching peripherals to a motherboard. Adapted from the
Peripheral Component Interconnect (PCI) bus. Originally designed for laptops and other
small-footprint computer systems.
MulticastThe delivery of information to a group of destinations simultaneously using the most efficient
strategy to deliver the messages over each link of the network only once, creating copies only
when the links to the destinations split.
N
NCBNon Channel bonding (20 MHz transmission)
nCBNon-Channel Bonding
NFSLinux's "Network File System" - A way to share files between machines on a network as if the
files were located on the client's local hard drive.
NWIDNetwork Identification Designator.
O
User’s Guide50Revision 1.1, 2013-05-06
Page 51
DUT Graphical User Interface
DUT Tool Package
Confidential
OCSOptimal Channel Selection
P
PBCPush Button Configuration
R
RFICRF Integrated Circuit
n
RSSIReceived Signal Strength Indication - a measureme
signal.
S
SISOSingle Input Single Output
STAInfrastructure Station
U
UUIDUniversally Unique Identifier
W
WEPWired Equivalent Privacy - The original secur
WPAWiFi Protected Access - A security protocol for
security than WEP via enhanced encryption and user authentication.
WPSWiFi Protected Setup - A protocol designed to make it easier to set up and configure security
Fi networks.
on Wi-
i
t of the power present in a received radio
ty protocol for Wi-Fi networks.
Wi-Fi networks which provides stronger
Terminology
CE
CE RF Radiation Ex
Caution This equipment complies with European RF radiation exposure limits set forth for
an uncontrolled environment. This equipment should be installed and operated with a
minimum distance of 20 centimeters between the radiator and your body. This transmitter
must not be co-located or operating in conjunction with any other antenna or transmitter.
posure Statement:
User’s Guide51Revision 1.1, 2013-05-06
Page 52
FCC Information
This device complies with part 15 of the FCC Results. Operation is subject to the
following two conditions :
(1) This device may not cause harmful interface, and
(2) This device must accept any interference received, including interference that
may cause undesired operation.
Note: This equipment has been tested and found to comply with the limits for CLASS B digital device,
pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against harmful
interference when the equipment is operated in a commercial environment This equipment generates, uses
and can radiate radio frequency energy and, if not installed and used in accordance with the instructions,
may cause harmful interference to radio communications. However, there is no guarantee that interference
will not occur in a particular installation. If this equipment does cause harmful interference to radio or
television reception, which can be determined by turning the equipment off and on, the user is encouraged
to try correct the interference by one or more of the following measures:
1.1. Reorient or relocate the receiving antenna.
1.2. Increase the separation between the equipment and receiver.
1.3. Connect the equipment into an outlet on a circuit different from that to which receiver is connected.
1.4. Consult the dealer or experienced radio/TV technician for help.
WARNING
Changes or modifications not expressly approved by the manufacturer could void the
user’s authority to operate the equipment.
Information for OEM Integrator
This device is intended only for OEM integrators under the following conditions:
1) The antenna must be installed such that 20 cm is maintained between the antenna and users, and
2) The transmitter module may not be co-located with any other transmitter or antenna.
End product labelling
The label for end product must include “Contains FCC ID: O6ZT9”.
“CAUTION : Exposure to Radio Frequency Radiation.
This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment. This
equipment must be installed and operated with minimum distance of 20cm between the radiator and your
body. This transmitter module is authorized only for use in device where the antenna may be installed such
that 20 cm may be maintained between the antenna and users.”
Page 53
www.lantiq.com
Published by Lantiq Deutschland GmbH
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.