This document provides an overview of Labtool for 88MW320 and 88MW322 devices.
Labtool is a software test tool used to control and run various RF and regulatory
compliance tests.
The Labtool application runs on a Windows PC. The Device Under Test (DUT) needs to
run the bridge application and MFG firmware. The PC is connected to the DUT via the
USB Virtual UART interface.
Figure 1 shows the Labtool test setup structure.
UM11449
88MW32x Labtool User Guide
Figure 1. Labtool test setup
Ensure to calibrate the RF cable losses on the Manufacturing (MFG) test setup across
different frequencies. This can be accomplished by using a network analyzer to measure
the entire path loss (S21).
For example, the entire path loss between the RF tester and the 88MW32x reference
design is measured from the N-Type to SMA adapter and DC block that connects to the
RF tester all the way to the W.FL cable/probe end that connects to the W.FL connector
on the 88MW32x reference designs.
This section describes the procedure on how to setup the Wi-Fi MFG firmware and
launch the bridge on a host PC to start the test.
The bridge firmware and Wi-Fi MFG firmware are located in the 88MW32x Flash. The
host Labtool communicates with the DUT firmware thru the virtualized UART interface.
See Figure 2.
Figure 2. Labtool, bridge, and Wi-Fi MFG firmware
UM11449
88MW32x Labtool User Guide
Program the bridge firmware and WLAN MFG firmware into the Flash through the
88MW32x reference design. The bridge firmware can be built thru the Software
Development Kit (SDK) environment. The Labtool release package includes the WLAN
MFG firmware.
Perform the following tasks:
1. Follow the document “Development-Host-Setup.pdf” in the SDK document package to
set up the environment to compile.
2. Follow the document “DeveloperReference-BuildSystem.pdf” to make the bridge
firmware.
3. Follow the document “Developing with WMSDK.pdf” and use the tool “flashprog.py”
in the SDK package to program the bridge firmware and WLAN MFG firmware into
Flash.
When setting up the environment to compile and preparing to build the bridge firmware,
configure as follows:
1. Execute the following command:
>make config
2. In the menu, choose the following options:
Platform type >
Wi-Fi Chipset >
Configures UART rcv Buffers of size 1024 (UART_LARGE_RCV_BUF) {N/Y]:Y
1.88MC200-based Platforms (CPU_MC200)
2.88MW300-based Platforms (CPU_MW300)
Choice {2-1]: 2
1.878x-based Chipset (WiFi-878x)
2.8801-based Chipset (WiFi-8801)
Choice {2-1]: 2
3. Keep the other parameters as the default configuration.
Open the “SetUp.ini” file using a text editor. Edit the ComNo parameter to match the USB
serial port number of the host. For the reference design boards, it will be virtualized as
two UART ports. Use a big port number.
[COMSET]
ComNo = 11
BaudRate = 1500000
Install the Zadig USB driver using the following link on the Windows PC for the reference
design board:
http://zadig.akeo.ie/
Once installed, the USB serial port number can be found in the Device Manager (see
Figure 5). Choose either the DB9 connector or Future Technologies Device International
(FTDI) based on the USB serial connector to connect to the Windows PC.
Ensure the bridge application is running prior to starting the Labtool application. The
procedure to start the Labtool application is as follows:
1. Double-click on DutApiWiFiMW30xBridgeUart.exe file.
UM11449
88MW32x Labtool User Guide
Figure 6 shows the Labtool start window for 88MW32x device.
Figure 6. Labtool start window
2. At the command prompt, enter 1 to start WLAN radio operation.
3. To confirm whether the bridge and host setups are working properly, issue the
command 88 to check the firmware and Labtool version number.
If the correct version numbers are returned, start the RF test procedure.
If the version numbers are incorrect, check the host, DUT, and bridge connections.
Confirm the WLAN driver is installed correctly.
Figure 7 shows the correct state of the Command 88 execution for the 88MW32x
4. Each time a Labtool command is executed, the console returns a status byte. A
UM11449
88MW32x Labtool User Guide
successful command execution is indicated by a status byte with all 0s. See Figure 8.
Figure 8. Status - Successful command execution
A failed command returns invalid data and is indicated by a non-0 status byte
(0x00000001 to 0xFFFFFFFF). See Figure 9. This could indicate a problem with the
communication to the DUT, incorrect firmware, no firmware download, wrong version
of Labtool/firmware, and so on.
Figure 9. Status – Failed command execution
5. Enter a ? at the Labtool prompt to list all the available commands.
4.3 Closing Labtool
To close Labtool application, issue the command 99.
4.4 Exiting Labtool
Issue the command 99 twice to fully exit the Wi-Fi section and Labtool application.
5.1.7 Command 25: Transmit with duty cycle Tx mode
This command places the device in duty cycle mode after the power is manually set. This
emulates packet based transmission with a packet-to-packet gap specified by the beacon
interval.
Syntax: 25 <Enable> <Data rate>
EnableMode enable
Data rateData rate. Refer to Table 3 for the mapping.
Examples:
25 1 13 // sets the duty cycle transmit at 54 Mbit/s
25 1 22 // sets the duty cycle transmit at HT_MCS7
25 0 // turns off the transmission
UM11449
88MW32x Labtool User Guide
ParameterDescription
0: disable
1: enable
Table 3. Data rate ID
IDData rateIDData rateIDData rate
11 Mbit/s66 Mbit/s15HT_MCS0
22 Mbit/s79 Mbit/s16HT_MCS1
35.5 Mbit/s812 Mbit/s17HT_MCS2
411 Mbit/s918 Mbit/s18HT_MCS3
5Reserved1024 Mbit/s19HT_MCS4
——1136 Mbit/s20HT_MCS5
——1248 Mbit/s21HT_MCS6
——1354 Mbit/s22HT_MCS7
——14Reserved——
5.1.8 Command 32: Get and clear Rx packet count
This command gets the Rx packet count, and clears the Rx packet counter (stop Rx
Frame Error Rate (FER) test).
This command continuously transmits standard 802.11 packets with an adjustable time
gap specified by a configurable Short Interframe Space (SIFS) interval.
This command returns the MAC address. Before this operation, the storage type must be
set to One Time Programmable (OTP).
Syntax: 45
Returns: MAC address
5.1.12 Command 46: Write the MAC address
This command writes the MAC address. Before this operation, the storage type must be
set to OTP.
Syntax: 46 <MAC Address>
Where:
MAC AddressMAC address in In xx.xx.xx.xx.xx.xx format
Example:
UM11449
88MW32x Labtool User Guide
ParameterDescription
46 00.50.43.21.12.34 // writes MAC address 00.50.43.21.12.34 to OTP
Returns: __
5.1.13 Command 53: Set the calibration data to storage from the text file
This command sets the calibration data to storage from the calibration data text file
(WlanCalData_ ext.conf). This allows the generation of a golden calibration file.
Syntax: 53
Examples:
44 1 // sets NO_EEPROM as storage type
53 // generates the calibration data file in .conf format (WlanCalData_ ext.conf) from
the text format (CalWlanDataFile.txt)
Returns: __
5.1.14 Command 54: Get the calibration data from storage into a text file
This command gets the calibration data from storage and saves it to
CalWlanDataFile_Upload.txt text file. This allows editing of available annex parameters
such as XTAL code, and FEM_loss.
5.1.15 Command 88: Get the firmware/hardware Version
This command returns the firmware, hardware, and Labtool versions.
Syntax: 88
Returns: the firmware/hardware information:
• DLL version
• Labtool version
• Firmware version
• Manufacturing version
• SoC version
• Baseband version
• RF version
• OR version
• Customer ID version
5.1.16 Command 95: Get XTAL calibration offset
This command gets the 8-bit crystal calibration offset.
UM11449
88MW32x Labtool User Guide
Syntax: 95
Returns: the 8-bit crystal calibration offset
5.1.17 Command 96: Set XTAL calibration offset
This command sets the 8-bit crystal calibration offset to adjust the frequency offset when
viewed on a Vector Signal Analyzer (VSA), a spectrum analyzer, or a frequency counter.
Syntax: 96 <XTAL offset value>
Where:
ParameterDescription
XTAL offset valueCrystal offset value in the range of 0x00 to 0xFF
Default: 0x80
Example:
96 B1 // sets XTAL offset value to 0xB1.
Returns: __
5.1.18 Command 99: Exit Labtool application
This command exits the Wi-Fi menu. Use the command 99 a second time to exit Labtool
applicaiton and close the command prompt window.
Draft — A draft status on a document indicates that the content is still
under internal review and subject to formal approval, which may result
in modifications or additions. NXP Semiconductors does not give any
representations or warranties as to the accuracy or completeness of
information included in a draft version of a document and shall have no
liability for the consequences of use of such information.
7.2 Disclaimers
Limited warranty and liability — Information in this document is believed
to be accurate and reliable. However, NXP Semiconductors does not
give any representations or warranties, expressed or implied, as to the
accuracy or completeness of such information and shall have no liability
for the consequences of use of such information. NXP Semiconductors
takes no responsibility for the content in this document if provided by an
information source outside of NXP Semiconductors. In no event shall NXP
Semiconductors be liable for any indirect, incidental, punitive, special or
consequential damages (including - without limitation - lost profits, lost
savings, business interruption, costs related to the removal or replacement
of any products or rework charges) whether or not such damages are based
on tort (including negligence), warranty, breach of contract or any other
legal theory. Notwithstanding any damages that customer might incur for
any reason whatsoever, NXP Semiconductors’ aggregate and cumulative
liability towards customer for the products described herein shall be limited
in accordance with the Terms and conditions of commercial sale of NXP
Semiconductors.
Right to make changes — NXP Semiconductors reserves the right to
make changes to information published in this document, including without
limitation specifications and product descriptions, at any time and without
notice. This document supersedes and replaces all information supplied prior
to the publication hereof.
Suitability for use — NXP Semiconductors products are not designed,
authorized or warranted to be suitable for use in life support, life-critical or
safety-critical systems or equipment, nor in applications where failure or
malfunction of an NXP Semiconductors product can reasonably be expected
to result in personal injury, death or severe property or environmental
damage. NXP Semiconductors and its suppliers accept no liability for
inclusion and/or use of NXP Semiconductors products in such equipment or
applications and therefore such inclusion and/or use is at the customer’s own
risk.
UM11449
88MW32x Labtool User Guide
products using NXP Semiconductors products, and NXP Semiconductors
accepts no liability for any assistance with applications or customer product
design. It is customer’s sole responsibility to determine whether the NXP
Semiconductors product is suitable and fit for the customer’s applications
and products planned, as well as for the planned application and use of
customer’s third party customer(s). Customers should provide appropriate
design and operating safeguards to minimize the risks associated with
their applications and products. NXP Semiconductors does not accept any
liability related to any default, damage, costs or problem which is based
on any weakness or default in the customer’s applications or products, or
the application or use by customer’s third party customer(s). Customer is
responsible for doing all necessary testing for the customer’s applications
and products using NXP Semiconductors products in order to avoid a
default of the applications and the products or of the application or use by
customer’s third party customer(s). NXP does not accept any liability in this
respect.
Export control — This document as well as the item(s) described herein
may be subject to export control regulations. Export might require a prior
authorization from competent authorities.
Evaluation products — This product is provided on an “as is” and “with all
faults” basis for evaluation purposes only. NXP Semiconductors, its affiliates
and their suppliers expressly disclaim all warranties, whether express,
implied or statutory, including but not limited to the implied warranties of
non-infringement, merchantability and fitness for a particular purpose. The
entire risk as to the quality, or arising out of the use or performance, of this
product remains with customer. In no event shall NXP Semiconductors, its
affiliates or their suppliers be liable to customer for any special, indirect,
consequential, punitive or incidental damages (including without limitation
damages for loss of business, business interruption, loss of use, loss of
data or information, and the like) arising out the use of or inability to use
the product, whether or not based on tort (including negligence), strict
liability, breach of contract, breach of warranty or any other theory, even if
advised of the possibility of such damages. Notwithstanding any damages
that customer might incur for any reason whatsoever (including without
limitation, all damages referenced above and all direct or general damages),
the entire liability of NXP Semiconductors, its affiliates and their suppliers
and customer’s exclusive remedy for all of the foregoing shall be limited to
actual damages incurred by customer based on reasonable reliance up to
the greater of the amount actually paid by customer for the product or five
dollars (US$5.00). The foregoing limitations, exclusions and disclaimers
shall apply to the maximum extent permitted by applicable law, even if any
remedy fails of its essential purpose.
Translations — A non-English (translated) version of a document is for
reference only. The English version shall prevail in case of any discrepancy
between the translated and English versions.
Applications — Applications that are described herein for any of these
products are for illustrative purposes only. NXP Semiconductors makes
no representation or warranty that such applications will be suitable
for the specified use without further testing or modification. Customers
are responsible for the design and operation of their applications and
6Acronyms and abbreviations ...........................18
7Legal information .............................................. 19
UM11449
88MW32x Labtool User Guide
Please be aware that important notices concerning this document and the product(s)
described herein, have been included in section 'Legal information'.