Z Com 0XG880M Users Manual

Manufacturing Test Suite

Model No.: XG-880M

Libertas™ 802.11g Client Card

Evaluation Tool User Guide

Doc. No. MV-S101517-00, Rev. – August 5, 2003

802.11g Client Card Evaluation Tool User Guide

Document Status

Adv an ced Information

Preliminary Information

Fi nal Information

Revision Code:

Proprietary Technical Publication:

This document contains design specifications for initial product development. Specifications may change without notice. Contact Marvell Field Application Engineers for more information.

This document contains preliminary data, and a revision of this document will be published at a later date. Specifications may change without notice. Contact Marvell Field Application Engineers for more information.

This document contains specifications on a product that is in final release. Specifications may change without notice. Contact Marvell Field Application Engineers for more information.

Proprietary Information

This document provides preliminary information about the products described, and such information should not be used for purpose of final design. Visit the Marvell® web site at www.marvell.com or call 1-866-674-7253 for the latest information on Marvell products.

Disclaimer

No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose, without the express written permission of Marvell. Marvell retains the right to make changes to this document at any time, without notice. Marvell makes no warranty of any kind, expressed or implied, with regard to any information contained in this document, including, but not limited to, the implied warranties of merchantability or fitness for any particular purpose. Further, Marvell does not warrant the accuracy or completeness of the information, text, graphics, or other items contained within this document. Marvell makes no commitment either to update or to keep current the information contained in this document. Marvell products are not designed for use in life-support equipment or applications that would cause a life-threatening situation if any such products failed. Do not use Marvell products in these types of equipment or applications. The user should contact Marvell to obtain the latest specifications before finalizing a product design. Marvell assumes no responsibility, either for use of these products or for any infringements of patents and trademarks, or other rights of third parties resulting from its use. No license is granted under any patents, patent rights, or trademarks of Marvell.These products may include one or more optional functions. The user has the choice of implementing any particular optional function. Should the user choose to implement any of these optional functions, it is possible that the use could be subject to third party intellectual property rights. Marvell recommends that the user investigate whether third party intellectual property rights are relevant to the intended use of these products and obtain licenses as appropriate under relevant intellectual property rights.

Marvell comprises Marvell Technology Group Ltd. (MTGL) and its subsidiaries, Marvell International Ltd. (MIL), Marvell Semiconductor, Inc. (MSI), Marvell Asia Pte Ltd. (MAPL), Marvell Japan K.K. (MJKK), Marvell Semiconductor Israel Ltd. (MSIL), SysKonnect GmbH, and Radlan Computer Communications, Ltd.

Export Controls. With respect to any of Marvell’s Information, the user or recipient, in the absence of appropriate U.S. government authorization, agrees: 1) not to re-export or release any such information consisting of technology, software or source code controlled for national security reasons by the U.S. Export Control Regulations ("EAR"), to a national of EAR Country Groups D:1 or E:2; 2) not to export the direct product of such technology or such software, to EAR Country Groups D:1 or E:2, if such technology or software and direct products thereof are controlled for national security reasons by the EAR; and, 3) in the case of technology controlled for national security reasons under the EAR where the direct product of the technology is a complete plant or component of a plant, not to export to EAR Country Groups D:1 or E:2 the direct product of the plant or major component thereof, if such direct product is controlled for national security reasons by the EAR, or is subject to controls under the U.S. Munitions List ("USML"). At all times hereunder, the recipient of any such information agrees that they shall be deemed to have manually signed this document in connection with their receipt of any such information.

Copyright © 2003. Marvell. All rights reserved. Marvell, the Marvell logo, Moving Forward Faster, Alaska, and GalNet are registered trademarks of Marvell. Discovery, Fastwriter, GalTis, Horizon, Libertas, Link Street, NetGX, PHY Advantage, Prestera, Raising The Technology Bar, UniMAC, Virtual Cable Tester, and Yukon are trademarks of Marvell. All other trademarks are the property of their respective owners.

Marvell 700 First Avenue Sunnyvale, CA 94089 Phone: (408) 222 2500 Sales Fax: (408) 752 9029 Email: commsales@marvell.com

Doc. No. MV-S101517-00 Rev. –

CONFIDENTIAL

Page 2 Document Classification: Proprietary Information August 5, 2003, Proprietary

Table of Contents

Section 1. Getting Started .................................................................................................... 5

1.1 Overview ................................................................................................................................... 5

1.2 Equipment .................................................................................................................................5

1.2.1 Test Setup...................................................................................................................................5

1.2.2 Calibration ...................................................................................................................................6

1.3 System Requirements............................................................................................................... 6

Section 2. Software Requirements ....................................................................................... 7

2.1 Manufacturing Test Software Suite Contents............................................................................ 7

2.2 Software Installation..................................................................................................................7

2.3 Windows Driver Installation....................................................................................................... 8

2.3.1 Driver Installation Procedure .......................................................................................................8

2.3.2 Programming Configuration Information .....................................................................................9

Section 3. Command Line Interface ................................................................................... 11

3.1 Using the Manual Test Module ...............................................................................................11

3.1.1 DUT Interface ............................................................................................................................11

3.1.2 Golden Unit Interface ................................................................................................................12

3.1.3 Additional Menu Interface..........................................................................................................13

3.1.4 Before Getting Started...............................................................................................................15

3.2 Receiver Sensitivity Test......................................................................................................... 16

3.2.1 Overview ...................................................................................................................................16

3.2.2 Test Procedure..........................................................................................................................16

3.3 Transmitter Tests .................................................................................................................... 17

3.4 Command Descriptions...........................................................................................................18

3.4.1 RF Commands ..........................................................................................................................18

3.4.2 FER Commands........................................................................................................................22

3.4.3 Configuration Information Access Commands ..........................................................................24

3.4.4 SPI/Flash Access Commands...................................................................................................25

3.4.5 Device Specific Commands ......................................................................................................27

3.4.6 Exit Test Command...................................................................................................................28

Appendix A.Sample CalDataFile.txt...................................................................................... 29

Section 4. Index.................................................................................................................. 33

Section 5. Revision History................................................................................................. 35

August 5, 2003, Preliminary Document Classification: Preliminary Information Page 3

CONFIDENTIAL

Doc. No. MV-S101517-00 Rev. –

802.11g Client Card Evaluation Tool User Guide

This page is intentionally left blank.

Doc. No. MV-S101517-00 Rev. –

Page 4 Document Classification: Preliminary Information August 5, 2003, Preliminary

CONFIDENTIAL

Getting Started

Overview

Section 1. Getting Started

1.1 Overview

This document explains how to use the software command line interface for the following Libertas™ Wireless LAN (WLAN) client cards:

• Marvell® CB-32 802.11g WLAN CardBus Card

• Marvell® MB-31 802.11g WLAN Mini PCI Card

These cards include the highly integrated Libertas™ IEEE 802.11g two-chip solutions for client applications. The chipset consists of the 88W8000G Radio Frequency Transceiver and the 88W8310 WLAN Client device.

1.2 Equipment

The overall setup for testing the capabilities and performance of the Libertas™ family of WLAN chipset solutions is shown in Figure 1. The setup shows the equipment required to test the transmit/receive chains and throughput between a DUT and a golden source. Proper shielding is required for both the DUT and the golden source.

1.2.1 Test Setup

Figure 1: Test Setup

Shielding Box

Attenuator

Power

Supply

RF Cable

GPIB

Power

Fast Ethernet/ Host Interface (control and data)

Host Interface (control and data)

Test Controller

DUT Switch

PCB

GPIB

optional

Splitter

Attenuator Attenuator

Spectrum

Analyzer

Fast Ethernet

Splitter

Power

Meter

Variable

Attenuator

Attenuator/

Switch Driver

Attenuator

Shielding Box

Golden Source

CONFIDENTIAL

Doc. No. MV-S101517-00 Rev. –

August 5, 2003, Preliminary Document Classification: Preliminary Information Page 5

Libertas™ 802.11g Client Card Evaluation Tool User Guide

1.2.2 Calibration

It is critical to obtain accurate measurements of the path loss (due to cables, connectors, etc.) from the DUT to the Golden Unit and from the DUT to the power meter. For path loss measurements, sum the loss of each individual component along the path. Figure 2 shows the RF path loss for calibration. Figure 3 shows the switch settings for the programmable attenuator.

Figure 2: RF Path

LAN

Master PC

8493A 11636B11636B

Attenuator

DUT

6 dB

Attenuator

6 dB

Agilent WLAN Test Set

Antenna 1 (2) to ESA = 18dB

Antenna 1 (2) to PM = 24dB

Antenna 1 (2) to Golden = 24dB

Golden to PM = 18dB

Figure 3: Switch Driver

Agilent 11713A Attenuator/Switch Driver

Attenuator X

1234

1 dB 2 dB 4 dB 4 dB

8762B

Divider

6 dB

ESA

Attenuator

6 dB

Divider

6 dB

Power

Meter

Attenuator

Attenuator Y

678

10 dB 20 dB 40 dB 40 dB

6 dB

8494H/8496H

Programmable

Attenuator

Attenuator/

Switch Driver

Attenuator

6 dB

Switches

Slave PC

Golden

Unit

1.3 System Requirements

• 300 MHz or faster CPU

• Windows® 2000 or 98SE (Second Edition)

• Marvell Libertas™ Client Card (CardBus or Mini PCI)

Doc. No. MV-S101517-00 Rev. –

CONFIDENTIAL

Page 6 Document Classification: Preliminary Information August 5, 2003, Preliminary

Software Requirements

Manufacturing Test Software Suite Contents

Section 2. Software Requirements

2.1 Manufacturing Test Software Suite Contents

Table 1: Manufacturing Test Software

Filename Description

SetUp.ini Setup file. See Figure 4.

DutApi98Dll.dll DLL file for DUT.

DutApiPci98_G.exe Manual test module executable for client card.

GoldenAP.exe Manual test module executable for AP golden unit.

CalDataFile.txt Example manufacturing calibration data file. See Appendix A. "Sample CalDataFile.txt" .

Spi.hex Hexadecimal file to program SPI (see command 35).

2.2 Software Installation

1. Copy the manufacturing test software files to a directory on the C: drive. DutApiPci98_G.exe, DutApi98Dll.dll, and SetUp.ini must be in the same directory.

2. Open the Setup.ini file with a text editor. When running both the DutApiPci98_G.exe and GoldenAP.exe test files, the Setup.ini should contain the Golden Unit IP addresses and DUT and Golden setup information:

Figure 4: Setup File

August 5, 2003, Preliminary Document Classification: Preliminary Information Page 7

CONFIDENTIAL

Doc. No. MV-S101517-00 Rev. –

Libertas™ 802.11g Client Card Evaluation Tool User Guide

2.3 Windows Driver Installation

Installation of the driver will allow the user to access hardware memory space. The following files are required:

• MWLAN_G.inf

• windrvr.vxd

• DutApiPci98_G.exe

• wdreg.exe

2.3.1 Driver Installation Procedure

Windows explorer may not show *.Vxd file on the folder. At the MS-DOS command prompt, use the directory (DIR) command to check the entire contents of the installation disk.

Notes

• In some of the commands below you are asked to type a text string enclosed in double quotes. Do not type the quotes, they are just there for clarity.

• Commands that you type in are in bold.

• Pressing the Enter key after typing in a text string is assumed.

1. Copy windrvr.vxd from the installation disk to c:\windows\system\vmm32 directory.

2. Create an application directory (for example, “mkdir c:\mactest”).

3. Copy DutApiPci98_G.exe and wdreg.exe from the installation disk to the application directory.

4. Insert the Marvell card and Windows 98SE will run the device installation wizard. Use the INF file (a:\MWLAN_G.inf) on the installation disk to install the device.

5. Open the MS-DOS command prompt window and change the directory to the application directory (for example, “cd c:\mactest”).

6. Type “WDREG.EXE -VXD install” to run the registration program. This is CASE-SENSITIVE. The following messages should appear:

Creating driver entry... OK

Starting driver entry.… OK

7. Open the MS-DOS command prompt window: a) Change the directory to the application directory (for example, “cd c:\mactest”).

b) Type “DutApiPci98_G.exe” to run the test program.

Doc. No. MV-S101517-00 Rev. –

Page 8 Document Classification: Preliminary Information August 5, 2003, Preliminary

CONFIDENTIAL

Software Requirements

Windows Driver Installation

2.3.2 Programming Configuration Information

The configuration information (MAC address, calibration data, CIS table, etc.) are saved in EEPROM and are accessed through the SPI interface. The image can be also programmed through the PCI interface. There are two ways to program the image (build-in SPI or with a hex file). Although the build-in image is more stable, loading the image from a hex file allows access to more recent information and allows more flexibility.

To program build-in image:

1. Type the command 37.

2. Type 38 to verify the image against the build-in image. There should be no errors reported.

3. Type 48.

This command programs the sub-PID and sub-VID for the Marvell Mini PCI card (47 for the CardBus).

To program the image from the file:

1. Type 39.

The current file name is displayed in brackets. The default is Spi.hex. When prompted for filename, either press Enter or type Spi.hex. If there is no change to the configuration, press Enter. If there is a change, the configuration information from the file name entered is retained for this execution (replaces the information in the default file).

2. Type 40.

This command will verify the image against the given file.

3. Type 48.

This command programs the sub-PID and sub-VID for the Marvell Mini PCI card (47 for the CardBus).

After downloading the image, or if the image already exists, the MAC address is programmed as follows:

1. Type “46 xx.xx.xx.xx.xx.xx”.

This command writes the MAC address (xx.xx.xx.xx.xx.xx). Use command 45 to view the MAC address currently programmed.

a) Use hexadecimal values in the following format: xx.xx.xx.xx.xx.xx for the MAC address. b) Enter the values with a period (.) in between number pairs.

2. Type 99 to exit.

Notes

• To view the these commands, run the DutApiPci98_G.exe file as follows: “DutApiPci98_G.exe -m”. The space is required between DutApiPci98_G.exe and -m. See 3.1.3 "Additional Menu Interface" on page 13.

• Command 37 can be used to download the build-in Spi.hex file. However, when a new Spi.hex is available, use command 39. When using command 37, use command

August 5, 2003, Preliminary Document Classification: Preliminary Information Page 9

CONFIDENTIAL

48 to program PID/VID.

Doc. No. MV-S101517-00 Rev. –

Libertas™ 802.11g Client Card Evaluation Tool User Guide

This page is intentionally left blank.

Doc. No. MV-S101517-00 Rev. –

Page 10 Document Classification: Preliminary Information August 5, 2003, Preliminary

CONFIDENTIAL

Command Line Interface

Using the Manual Test Module

Section 3. Command Line Interface

3.1 Using the Manual Test Module

The manual test module runs through a simple menu-driven interface. Two executable files are needed for the test. The Setup.ini file must be located in the same directory as the executable files.

• DutApiPci98_G.exe. Controls the CardBus and Mini PCI cards.

• GoldenAP.exe. Controls the Golden unit. Needed for Rx Sensitivity tests (unless a signal generator is used).

• Setup.ini

Run both the DutApiPci98_G.exe and GoldenAP.exe files to launch the tool. Each command is numbered, and some commands accept input parameters. For example, to retrieve the current channel setting, type 11 and press Enter. This command returns the current channel. To set the channel to 6, type “12 6” and press Enter, where 12 is the command and 6 is the input parameter.

3.1.1 DUT Interface

Figure 5: PCI Interface Test Menu (DutApiPci98_G.exe)

August 5, 2003, Preliminary Document Classification: Preliminary Information Page 11

CONFIDENTIAL

Doc. No. MV-S101517-00 Rev. –

Libertas™ 802.11g Client Card Evaluation Tool User Guide

3.1.2 Golden Unit Interface

Figure 6: Golden AP Main Menu (GoldenAP.exe)

Doc. No. MV-S101517-00 Rev. –

Page 12 Document Classification: Preliminary Information August 5, 2003, Preliminary

CONFIDENTIAL

+ 26 hidden pages