v2.3 Communication Machinery Corporation | 402 E. Gutierrez Street | Santa Barbara, CA. 93101 Phone: 1.805.879.1521| Fax: 1.805.564.7188 | Web: www.cmc.
Communication Machinery Corporation (CMC) Copyright & Trademark Notices Copyright 2004 by Communication Machinery Corporation (CMC). All rights reserved. This document may not be reproduced in whole or in part by any means without the written consent of CMC. EmulationEngine and vSTA are registered trademarks of Communication Machinery Corporation. The web-based user interface uses the GoAhead WebServer: Copyright (c) 2003 GoAhead Software, Inc. All rights reserved.
EmulationEngine 11a/b/g User's Guide TABLE OF CONTENTS CHAPTER 1: Overview ................................................................ ................................................................................................ ................................................................................................ .................................................................. .................................. 1-1 Packaging Checklist ...................................................
Communication Machinery Corporation (CMC) EE->Reconnect EE.................................................................................5-41 EE->Reset EE .......................................................................................5-42 EE->Reboot EE .....................................................................................5-42 Monitors Side Bar .....................................................................................5-43 Monitors->New Monitor.............................
EmulationEngine 11a/b/g User's Guide get wirelessmode ................................................................................ 6-7 set wirelessmode ................................................................................ 6-8 Virtual Station Set-Up & Control Commands ................................................. 6-8 acquireip ..............................................................................................6-10 assoc ...........................................................
Communication Machinery Corporation (CMC) set evlog module................................................................................6-35 EmulationEngine Commands ......................................................................6-35 association (get) ...................................................................................6-37 channel (get) ........................................................................................6-37 config (get) ..........................................
EmulationEngine 11a/b/g User's Guide set power ..........................................................................................6-47 psinterval (get/set) ...............................................................................6-48 get psinterval ....................................................................................6-48 set psinterval.....................................................................................6-48 quit ...................................................
Communication Machinery Corporation (CMC) set calibration ....................................................................................6-57 cp .......................................................................................................6-57 format .................................................................................................6-57 hostipaddr (get/set) ..............................................................................6-57 get hostipaddr .........................
EmulationEngine 11a/b/g User's Guide APPENDIX B: Software Upgrades ................................................................ ................................................................................................ ................................................................................. ................................................. B-1 APPENDIX C: Cable Pin Assignments ................................................................ ...............................................
Communication Machinery Corporation (CMC) x 080104
EmulationEngine 11a/b/g User's Guide CHAPTER 1: Overview The EmulationEngine is a test and measurement device that emulates up to 64 wireless stations in an IEEE 802.11 wireless LAN environment. The EmulationEngine operates in accordance with the IEEE 802.11a, 802.11b, and 802.11g specifications. The EmulationEngine is offered in three configurations: !" EmulationEngine 11a: Supports IEEE 802.11a only. !" EmulationEngine 11b: Supports IEEE 802.11b only. !" EmulationEngine 11a/b/g: Supports IEEE 802.
Communication Machinery Corporation (CMC) !" Release Notes !" Warranty Card !" End User License Agreement !" Installation CD-ROM which includes this User's Guide, the EmulationEngine Test Setup & Configuration Guide, and the Perl SDK. If any of these items are not included in your shipping container, contact CMC. Feature List !" Supports IEEE 802.11a, 802.11b, and 802.
EmulationEngine 11a/b/g User's Guide Files The following files are maintained in the EmulationEngine’s flash file system: 1) EmulationEngine Configuration (eecfg) 2) Scenario definitions 3) Logs 4) Statistics 5) EE22.SYS 6) keyfile 1) The EmulationEngine configuration file (eecfg) stores information settings that can be defined via the CLI or the web-based user interface. A backup version (.bak) of this file is also maintained in the unlikely event that the original might become corrupted.
Communication Machinery Corporation (CMC) Hardware Characteristics Ethernet Compatibility: The EmulationEngine can attach directly to 10BASE-T/100BASE-TX (twisted-pair) Ethernet LAN Hubs, segments or a PC. All of these must conform to the IEEE 802.3 specification. Radio Characteristics: The EmulationEngine conforms to the IEEE 802.11a, 802.11b, and 802.11g specifications. In 802.11a mode, it operates at the 5GHz Unlicensed National Information Infrastructure (UNII) band.
EmulationEngine 11a/b/g User's Guide CHAPTER 2: Connectors, LEDs & Antennas Front Panel/LEDs LED Status Description Power Off Power is not supplied to the EmulationEngine On Power is supplied to the EmulationEngine Flashing Running a self test, loading software, or system errors 10/100: Off No Ethernet activity 100: On Green Indicates 100 Mbps Ethernet cable link 10: On Green Indicates 10 Mbps Ethernet cable link 100: Flashing Green The EmulationEngine is transmitting or receiving data
Communication Machinery Corporation (CMC) Back Panel Connectors 10/100 Ethernet Connector: This connector provides 10/100 Mbps connectivity to a wired Ethernet LAN. It is used to connect a command PC to the EmulationEngine. Serial Port: This connector can also be used to connect a command PC to the EmulationEngine.
EmulationEngine 11a/b/g User's Guide CHAPTER 3: Installation Use the provided Power Adapter to supply power to the EmulationEngine. Connecting Directly to a Command PC !" Connect one end of the supplied Ethernet crossover cable to the Ethernet port on the command PC. !" Connect the other end of the crossover cable to the RJ-45 Ethernet Connector on the EmulationEngine.
Communication Machinery Corporation (CMC) 3-2 080104
EmulationEngine 11a/b/g User's Guide CHAPTER 4: Initial Setup For an Ethernet Port Connection If the Command PC is attached to the Ethernet Port on the EmulationEngine, complete the following steps to configure the Command PC and access the EmulationEngine web-based user interface or Command Line Interface (CLI): 1) Select Control Panel from the Start menu on the PC. 2) Double click on the Network Connections icon.
Communication Machinery Corporation (CMC) 6) Select the “Use the following IP address” radio button and enter the IP address for the Ethernet connection. Use an IP Address that resides on the same IP subnet as the EmulationEngine. For example, use 192.168.0.2 if you are using the EmulationEngine's default IP address 192.168.0.50. 7) Click “OK” to close the Internet Protocol (TCP/IP) Properties dialog. 8) Click the Close button in the Local Area Connection Properties dialog.
EmulationEngine 11a/b/g User's Guide Command Line Interface (CLI): You can use a PC that is connected via Telnet to access the CLI. For initial setup, use the EmulationEngine's default IP address 192.168.0.50 to establish a Telnet connection. Example: telnet 192.168.0.50 See Chapter 5 for information about using the web-based user interface. See Chapter 6 for information about using the CLI.
Communication Machinery Corporation (CMC) 4) Select the COM port that is connected to the EmulationEngine from the “Connect using” list box. Click OK to display the COM properties dialog: 5) Set the COM port settings as shown in this dialog: Bits per second: 9600, Data bits: 8, Parity: None, Stop bits: 1, Flow control: None. 6) Click OK to close the COM properties dialog.
EmulationEngine 11a/b/g User's Guide Ethernet PHY register test Ethernet interrupt test Pl : passed : passed Atheros AP 8245 Reference Design version 2.3.0.70 0 auto-booting... Attaching to TFFS... done. Loading /fl/ee22.sys...1028084 Starting at 0x480000... Reading Configuration File "/fl/eecfg". Configuration file checksum: 19eb7 is good Please check the ethernet cable! Attaching interface lo0...done Starting WLAN ... Starting quick passive scan ... Passive scanning 5 GHz 54Mbps (802.
Communication Machinery Corporation (CMC) 4-6 080104
EmulationEngine 11a/b/g User's Guide CHAPTER 5: The Web-Based User Interface System Requirements The command PC must be equipped with: !" Microsoft Windows 2000/XP !" Microsoft Internet Explorer Version 6.0 or higher !" Recommended Memory: 256 MB !" Recommended Virtual Memory: 300 MB !" Recommended Processor Speed: PIII 700 MHz Start-Up/Login !" Launch Internet Explorer. !" Enter the IP address of the EmulationEngine in the URL address field of the browser (e.g., http://192.168.0.50).
Communication Machinery Corporation (CMC) !" Select “Yes” to build a scenario in the user interface that is based on the virtual stations that are already defined in the EmulationEngine. !" Select “No” to delete the virtual station definitions in the EmulationEngine and create a new empty scenario. !" Select “Cancel” to retain the virtual stations in the EmulationEngine but do not create a new empty scenario.
EmulationEngine 11a/b/g User's Guide !" Uncheck the “Show On Startup” checkbox if you do not want to show this screen each time you access the EmulationEngine web server. You can restore this screen on start-up in the UI Configuration dialog (See Configuration->Preferences).
Communication Machinery Corporation (CMC) Open Existing Scenario If you selected “Open Existing Scenario” in the welcome screen and have not joined with a target system, the Select System Under Test dialog is displayed as described above. After you have joined with a target system, the Open Scenario dialog will be displayed: The list box shows a list of scenario files on the EmulationEngine. Select “Browse” to select from scenario files stored on the command PC.
EmulationEngine 11a/b/g User's Guide The content of this page will be different depending on whether you created a new scenario, opened an existing scenario, or cancelled/closed any of the start-up dialogs. This example page shows an existing scenario where one group is defined. This section of the page will be blank (No Scenario Defined) if a scenario has not been created.
Communication Machinery Corporation (CMC) Wireless Mode: This field shows the EmulationEngine’s current wireless mode (11a, 11b, or 11g). You can select a different wireless mode from the list box. The web-based user interface will issue a command to the EmulationEngine to change its wireless mode and scan for compatible systems. The results of the new scan will be reflected in the BSSIDs in the list box. Click on a BSSID in the list box and click “Join” to continue.
EmulationEngine 11a/b/g User's Guide Step 3) If you want the EmulationEngine to dynamically assign IP addresses, select DHCP from the Address Generation drop-down list box. Otherwise, enter an IP address in the Starting IP Address field to define the starting IP address to be used by virtual stations that are created in this scenario. Virtual stations will be created with unique IP addresses, sequentially or randomly, based on this starting IP address. Step 4) Select the Traffic tab.
Communication Machinery Corporation (CMC) Step 5) Make sure the Target IP Address field is set to the address of a target server to be pinged. The default IP address (0.0.0.0) shown in this example screen must be replaced by a valid IP address (e.g., 10.10.10.19). Click “Create” to create a group with five virtual stations. See "vSTA->New Group" for more information about defining and editing groups and virtual stations in a scenario.
EmulationEngine 11a/b/g User's Guide !" Complete steps 1) through 4) as described above for “Creating an Internal Mode Test”. !" In Step 5), select “External” in the “Traffic Source” field and select the Layer 2 radio button to capture frames based on 802.3 MAC source address or the Layer 3 radio button to capture frames based on IP source address. !" Click the Create button to create the scenario for an external mode test.
Communication Machinery Corporation (CMC) Type a name in the File Name field. Do not use colon (:), asterisk (*), question mark (?), quotes (“”), less-than/greater than signs (< >), vertical bar (|), or spaces in a file name. !" Select “Save(EE)” to save the scenario in the EmulationEngine’s flash file system. !" Select “Save(PC)” to save the scenario on the command PC. A standard save dialog will be displayed. Type a name in the File Name field.
EmulationEngine 11a/b/g User's Guide About/Using the Main Page The following illustration shows the general format of the main page where a scenario with one group of virtual stations has been defined and the group tab (Grp_1) is selected: When the “Group Control” tab is selected, the main page will show the Load Profile and a list of devices that have been discovered (if any) in a scan: 080104 5-11
Communication Machinery Corporation (CMC) !" Menu Toolbar: The top-left toolbar at the top of the page is a drop-down menu bar of all EmulationEngine functions. !" Status Toolbar: The top-right toolbar shows the status of the EmulationEngine, the System Under Test and the current time on the command PC. The status (e.g., Online) next to the EmulationEngine IP Address Address indicates the current status of the EmulationEngine with the web-based user interface.
EmulationEngine 11a/b/g User's Guide 080104 !" Scenario Toolbar: The buttons in this section of the toolbar can be used to run, pause, stop, restart, or refresh the entire scenario of all virtual stations. !" vSTA Toolbar: The buttons in this toolbar are used to initialize, authenticate, associate, run, pause, stop, disassociate, de-authenticate, restart, or refresh selected virtual stations or groups of virtual stations.
Communication Machinery Corporation (CMC) Group Control Grid When the Group Control tab is selected, the table shows the status of each group and its associated virtual stations: Group: This field displays the name of each group. The name is assigned in the New Emulation Group dialog (See vSTA->New Group). The remaining fields in the group line are counters that show the state of each group’s virtual stations during a test.
EmulationEngine 11a/b/g User's Guide Total: This field shows the total number of virtual stations in each group. Down: This field shows the total number of virtual stations in a group that have not been configured in the EmulationEngine and are in a “down” state. Configured: This field shows the total number of virtual stations in each group that have been configured in the EmulationEngine.
Communication Machinery Corporation (CMC) Status Messages: This column shows status and/or error messages returned by the EmulationEngine for each virtual station in the scenario group. See Appendix D for a list of messages that may be displayed in this column. Pkts Rcvd: This column shows the total number of packets received by each virtual station in this group. Pkts Xmtd: This column shows the total number of packets transmitted by each virtual station in this group.
EmulationEngine 11a/b/g User's Guide See vSTA->Add New vSTA to Group for information about the fields in this dialog. You can right click on selected virtual stations to display the vSTA menu. Any menu option will affect the selected virtual station(s).
Communication Machinery Corporation (CMC) Group Tab Columns: Within a group, you can double click on the table heading to configure the columns that are displayed. Select one or more items in the All Columns list box and click the [>>] button to move them to the Selected Columns list box. Click “Modify” to add the columns to the group table. Select “Reset” to return the columns to their default setting.
EmulationEngine 11a/b/g User's Guide systems with a higher signal strength value have a better/higher transmission rate to the EmulationEngine. You can select “Rescan” to instruct the EmulationEngine to rescan for all systems. The devices shown in this list box will be displayed in the Select System Under Test dialog where you can choose a system to test. Load Profile/Monitor Graphs The bottom half of the web page is reserved for charts that graphically illustrate a load profile and monitor test results.
Communication Machinery Corporation (CMC) Range Checking/Error Messages In the dialogs described later in this chapter, the user interface will verify all entries that require values within a specified range. If a field can contain a very large number, do not enter commas (,) for values larger than 999 (e.g., use 1000 rather than 1,000). If you use an invalid character in a field or specify a value that is not within range, a dialog will tell you the allowable range.
EmulationEngine 11a/b/g User's Guide per: This field defines what scheduling is based on (All vSTA = all virtual stations, Groups = virtual stations within each group). If "All vSTA" is selected, the Load Profile will run the next “run” number of virtual stations at each scheduled iteration. If Group is selected, the Load Profile will run the next “run” number of virtual stations from each group at each scheduled iteration. The scheduled iteration is defined in the “every” field.
Communication Machinery Corporation (CMC) vSTA Side Bar In the web-based user interface you can create scenarios that consist of one or more groups of virtual stations. The group configuration defines a test sequence that the EmulationEngine will activate to exercise the System Under Test. Virtual stations can be configured individually or by group. In internal mode, you can configure each virtual station and/or group to generate traffic to the system being tested.
EmulationEngine 11a/b/g User's Guide Group Name: Use a group name that helps you identify the devices that will be tested (e.g., Warehouse, Stock_Room, Control_Tour, Shop_Floor, etc.). It can be up to 12 characters (a...z, 0..9, and underscore (_)). EE Address: This field shows the IP address of the EmulationEngine that will run this scenario/test. Number of Virtual Stations: Enter the number of virtual stations (0...64) to be created in this scenario group. The default value is 5.
Communication Machinery Corporation (CMC) Netmask: This field shows the network mask to be used by virtual stations in this group. It is not settable here. It is global for all virtual stations and is an EmulationEngine configuration parameter. Ending IP Address: If Random is selected in the Address Generation field, enter the ending IP address to be used by virtual stations in this group when generating random addresses within a range.