EmulationEngine 11a/b/g User's Guide CHAPTER 6: The Command Line Interface (CLI) The CLI can be used to display and modify the configuration of the EmulationEngine from a PC that is connected via Telnet or the serial port. The CLI also includes commands to configure and run virtual stations, display statistics, and to access the System Under Test. The EmulationEngine maintains statistics and event log files that you can configure and display using CLI commands.
Communication Machinery Corporation (CMC) NOTE: If the CLI displays the message “This EmulationEngine has not been Node Locked” after you enter the EE login name and password, see “Missing Key File” in Chapter 9, Troubleshooting. User Log-Off Use the quit command to log off from the CLI: CMC_EE -> quit After log-off, you must reopen the telnet connection to log in to the CLI. CLI Commands The “help” command will display a list of all CLI commands.
EmulationEngine 11a/b/g User's Guide get keyentrymethod -- Display Encryption Key Entry Method get login -- Display Login User Name get pmmode -- Display Power Management Mode get power -- Display Transmit Power Setting get psinterval -- Display Power Save Listen Interval get rate -- Display Data Rate get shortpreamble -- Display Short Preamble (11b/11g) Usage get shortslottime -- Display Short Slot Time (11g) Usage get sntpserver -- Display SNTP/NTP Server IP Address get ssid -- Display Service Set ID get
Communication Machinery Corporation (CMC) set shortpreamble -- Set Short Preamble (11b/11g) Usage set shortslottime -- Set Short Slot Time (11g) Usage set sntpserver -- Set SNTP/NTP Server IP Address set ssid -- Set Service Set ID set systemname -- Set the EmulationEngine system name set telnet -- Set Telnet Mode set time -- Set the system time set tzone -- Set Time Zone Setting set vsta -- Set vSTA configuration parameters set wirelessmode -- Set Wireless LAN Mode timeofday -- Display Current Time of Day
EmulationEngine 11a/b/g User's Guide bssid (get/set/clear) get bssid This command shows the current BSSID/MAC address of the system that is being tested. get bssid Example: CMC_EE -> get bssid BSSID of System Under Test: 00:04:e2:34:e0:a8 CMC_EE -> set bssid This command specifies the BSSID/MAC address of the system to be tested. This is the System Under Test that the EmulationEngine will scan for and join with. The default value is all zeros.
Communication Machinery Corporation (CMC) join This command joins with the System Under Test. It must be present in the current Basic Service Set list. See the bsslist command. join Example: CMC_EE -> join The join should take about 1 sec CMC_EE -> EE Join: Checking BSS ... OK EE Join: Checking channel ... OK EE Join: Initiating JOIN ... Infrastructure 5.260 55 00:04:e2:38:a8:d2 SMC_03 EE Join: channel 5260, SMC_03 OK CMC_EE -> vSTA ID:0 NOTIFY Operation JOIN succeeded.
EmulationEngine 11a/b/g User's Guide Attempt a join with SUT 00:04:e2:38:a8:d2 [y/n: n]? The scan should take about 4 sec CMC_EE -> OK CMC_EE -> CMC_EE -> Passive scanning 5 GHz 54Mbps (802.11a) channels for 4 seconds... BSS No. 0 BSSID 00:04:E2:38:A8:D2 BSS No. 1 BSSID 00:04:E2:38:56:68 BSS No. 2 BSSID 00:04:E2:37:E6:A1 BSS No. 3 BSSID 00:04:E2:38:A7:87 Select BSS: Looking for .. 00:04:E2:38:A8:D2 Select BSS: Found ........
Communication Machinery Corporation (CMC) Example: CMC_EE -> get wirelessmode Wireless LAN Mode: 11g CMC_EE -> set wirelessmode This command sets the EmulationEngine’s Wireless LAN Mode: set wirelessmode : 11a = 802.11a, 11b = 802.11b, or 11g = 802.11g. The default value is 11g. NOTE: The feature set you ordered from CMC may limit the number of available wireless mode selections. The CLI will display an error message if the wireless mode selection is not in your feature set.
EmulationEngine 11a/b/g User's Guide NOTES: The state names used in the diagram are defined as follows: Null: The virtual station does not yet exist, it hasn't been created (i.e., configured). Configured: The initial configuration parameters for the virtual station have been defined. Initialized: The virtual station has been added to the system's internal tables (addressing, etc.). Authenticated: The virtual station has been authenticated with the System Under Test.
Communication Machinery Corporation (CMC) acquireip This command initiates the DHCP negotiation process for the specified virtual station(s). The virtual station must be in the 802.11 Associated state and the vSTA’s DHCP mode (dhcpmode) must be set to “on”. See the autoconf, conf, and set vsta commands for information about setting DHCP mode. acquireip : Virtual Station ID (1...64), Group ID (1...64), or “all” Example: CMC_EE -> acquireip vsta 1 CMC_EE -> OK vSTA ID:1 NOTIFY Operation ACQIP (10.1.
EmulationEngine 11a/b/g User's Guide The following command will initiate the authentication sequence for all virtual stations in a specified group. auth group : Group ID (1...64) Example: CMC_EE -> auth vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY Operation AUTH succeeded - TUE JUL 15 03:08:15 2003 autoconf This command can be used to configure, initialize, authenticate and associate a number of virtual stations using a single command. It can be issued multiple times.
Communication Machinery Corporation (CMC) [group ]: Optional group ID number (1...64). [csmode persistent|non-persistent]: Connection mode (persistent or nonpersistent). [retry ]: If csmode is presistent, this parameter specifies the Authentication/Association retry limit (1...2,147,483,647 or zero (=no retries)). [timeout ]: If csmode is presistent, this parameter specifies the Authentication/Association timeout in milliseconds (1...2,147,483,647 or zero (=immediate timeout)).
EmulationEngine 11a/b/g User's Guide [rtsthreshold ]: can be a value in the range 1...2346 and defines the RTS threshold for the virtual station(s) configured by this command. Any frame to be transmitted by a vSTA that exceeds the vSTA’s RTS threshold will require a successful RTS/CTS frame exchange before the frame is transmitted. The minimum value (1) effectively requires RTS/CTS for all transmit frames. The maximum value (2346) is the maximum 802.
Communication Machinery Corporation (CMC) Connection Mode ........... persistent Auth/Assoc Retry .......... 2 Authentication Timeout .... 300 mSec Association Timeout ....... 300 mSec Authentication ............ Open-System Cipher .................... WEP(RC4) Data Encryption ........... Off Shared-key Index .......... 0 Fragmentation Threshold ... 2346 RTS Threshold ............. 2346 Mode ...................... external Layer .................. 3 Load Application .......... ping Target IP Address ......
EmulationEngine 11a/b/g User's Guide [nVstas]: Optional number of virtual stations (1...64). If this parameter is omitted, the total number of auto-configured (autoconf) virtual stations is used. conf This command configures a virtual station. It specifies a virtual station's IP address, WLAN MAC address and load application mode. It also specifies the load application protocol, target host and application specific parameters.
Communication Machinery Corporation (CMC) Attribute Default Value timeout 300 The “set vsta” command can be used to change any of these default values. Examples: CMC_EE -> conf 3 10.1.40.20 00:0b:cd:59:00:01 internal ping 10.1.40.16 64000 1024 CMC_EE -> OK CMC_EE -> conf 1 10.1.35.150 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024 CMC_EE -> OK CMC_EE -> conf 1 on 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024 CMC_EE -> OK CMC_EE -> conf 1 auto 02:CF:1F:00:00:01 int ping 10.1.35.
EmulationEngine 11a/b/g User's Guide The following command will initiate the disassociation sequence for all virtual stations in a specified group. disassoc group : Group ID (1...64) Example: CMC_EE -> disassoc vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY Operation DISASSOC succeeded - TUE JUL 15 03:09:50 2003 group (clear/del/get/reset/save/set) These commands display and modify group configuration.
Communication Machinery Corporation (CMC) : Group Number (1...64). If is “summary”, you may specify “all” as the group number (i.e., get group all summary) to display summary statistics for all groups. : The attribute of the information to get/display. It can be one of the following. See the set group command for a more detailed description of the information that may be shown by each of these attributes.
EmulationEngine 11a/b/g User's Guide reset group This command resets all virtual stations in a group to the Initialized state and clears all group statistics counters. reset group : Group Number (1...64) Example: CMC_EE -> reset group 1 5 vSTAs reset CMC_EE -> save group stats This command saves statistics information in a file for all virtual stations in a specified group. Each virtual station in the group is saved to its own file.
Communication Machinery Corporation (CMC) Default layer 2 or 3 3 lp “ping” ping mode “external” or “internal” internal retry 0...2,147,483,647 2 rtsthreshold 1...2346 2346 size 64...1024 1024 target An IP address in ASCII Dotted Decimal Notation: nnn.nnn.nnn.nnn (e.g., 10.1.35.100). none timeout 0...2,147,483,647 300 authentication: This attribute sets the authentication mode (opensystem or shared-key) for all virtual stations in the specified group.
EmulationEngine 11a/b/g User's Guide layer: If mode is external, this parameter specifies how the external data stream is captured. If layer is 2, frames will be captured based on the source 802.3 MAC address. If layer is 3, frames will be captured based on the source IP address. The default value is 3. lp: If mode is “internal”, this attribute defines the Load Protocol (ping). mode: This attribute defines the test mode (internal or external) for all virtual stations in the specified group.
Communication Machinery Corporation (CMC) init This command initializes one or more virtual stations. A virtual station must be configured before it can be initialized. See the "conf" command. The following command initializes one or all virtual stations. init vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., init vsta all), all virtual stations are initialized. The following command initializes all virtual stations in a specified group.
EmulationEngine 11a/b/g User's Guide vsta (clear/del/get/reset/save/set) These commands can be used to clear virtual station statistics, delete virtual stations from the system, display virtual station configuration and statistics, reset virtual stations, save virtual station statistics in a file, and to set virtual station parameters. clear vsta stats This command clears all statistics for one or more virtual stations. clear vsta stats : Virtual Station ID (1...64), "all", or "master".
Communication Machinery Corporation (CMC) !" csmode: Display the virtual station’s connection mode (persistent or nonpersistent). !" dhcpinfo: If dhcpmode is “on” or “auto”, display DHCP information. !" dhcpmode: Display the DHCP Mode setting (on, off, or auto). !" encryption: Display the virtual station’s encryption mode (on or off). !" fragmentthreshold: Display the fragmentation threshold setting (256...2346).
EmulationEngine 11a/b/g User's Guide Pkts rcvd err .... state err ...... xid err ........ Requested lease .. Lease duration ... Expiration ticks . Renewal ticks .... Rebind ticks ..... Leased Address ... DHCP Server ...... Relay ............ Server/relay MAC . Subnet Mask ...... Gateway .......... DNS Server ....... 0 0 1 3600 3600 3577 1777 3127 10.1.35.56 10.2.10.10 10.1.35.1 00:00:00:00:00:00 255.255.255.0 10.1.35.1 0.0.0.0 Example get vsta : CMC_EE->get vsta 1 vSTA Configuration: ID .........
Communication Machinery Corporation (CMC) Rcv Sig Strength: 72, Ack Sig Strength: 83 Rcv Rate: 24, Tx SF Rate: 54, Tx LF Rate: 54 Frame counts: MSDUs Data Mcast Mgmt Ctrl Rcv 240 238 0 2 0 Tx 95 97 0 2 0 vSTA 1 Ping statistics: Transmit count: 1000 Transmit data size: 1024 Packets transmitted: 96 Round-trip (uSec): Bytes transmitted: 99072 Min: 50000 Transmit ENOBUFS: 0 Max: 100000 Packets received: 96 Avg: 74725 Bytes received: 99072 Stddev: 25137 Packet loss: 0% Rcv Errors: 64, Tx Errors: 4 Rcv PHY Error
EmulationEngine 11a/b/g User's Guide Example get vsta all conf: CMC_EE -> get vsta all conf vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ...
Communication Machinery Corporation (CMC) Example: CMC_EE -> reset vsta 1 CMC_EE -> save vsta stats This command writes all statistics for virtual stations to a file in the flash file system. The file will be stored in the /Statistics subdirectory and named "Vsta#Stats.dat" (where "#" is the virtual station ID). save vsta stats : Virtual Station ID (1...64), "all", or "master". If is set to all (i.e.
EmulationEngine 11a/b/g User's Guide Default Decimal Notation: nnn.nnn.nnn.nnn (e.g., 10.1.35.100) keyindex 1, 2, 3, or 4 1 (i.e., shared key 0) layer 2 or 3 3 lp “ping” ping mac MAC address in ASCII Colon Separated Hexadecimal Notation: xx:xx:xx:xx:xx:xx (e.g., 02:cf:1f:00:00:01) none mode “external” or “internal” internal retry 0...2,147,483,647 2 rtsthreshold 1...2346 2346 size 64...1024 1024 target An IP address in ASCII Dotted Decimal Notation: nnn.nnn.
Communication Machinery Corporation (CMC) encryption: This attribute sets the encryption mode (on or off) for virtual station(s) configured by this command. fragmentthreshold: This attribute defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold will limit the number of bytes in any 802.11 frame transmitted by the vSTA. If is set to 2346 (i.e., the maximum 802.11 frame size), fragmentation is effectively disabled.
EmulationEngine 11a/b/g User's Guide Statistics File Commands The del del get get following commands can be used to display and delete statistics files: statfile -- Delete a vSTA statistics file summfile -- Delete a vSTA statistics summary file statfile -- Display vSTA statistics from file summfile -- Display vSTA statistics summary from file See "Chapter 8, Statistics Counters" for a description of the fields that may be displayed by any of the commands in this group that display statistics counters.
Communication Machinery Corporation (CMC) get statfile group : Group ID (1...64) get statfile vsta This command retrieves and displays a statistics file for one or more virtual stations. get statfile vsta : Virtual Station ID (1...64), "all", or "master". If is set to "all" (i.e., get statfile vsta all), this command will display the statistics file for all virtual stations. If is set to "master" (i.e.
EmulationEngine 11a/b/g User's Guide Get/Display Event Log get evlog buffer This command displays event log data from the event log buffer. get evlog buffer : the number of records to display. The CLI will display the last number of records in the buffer. Omit this parameter to show all records in the buffer. Example: CMC_EE -> get evlog buffer 1/17/2003,10:25:14,5527.040462,0, Joined, BSSID 00:04:e2:38:52:18, chan 5280 1/17/2003,10:27:19,5651.922666,1, vSta conf ID 1, IP 10.1.35.
Communication Machinery Corporation (CMC) 5/5/2003,15:21:46,84.689242,9, vSTA 2: initialized 5/5/2003,15:21:46,85.022468,10, vSTA 1: authenticated 5/5/2003,15:21:47,85.272568,11, vSTA 2: authenticated 5/5/2003,15:21:47,85.522474,12, vSTA 1: associated 5/5/2003,15:21:47,85.772538,13, vSTA 2: associated 5/5/2003,15:21:53,91.422499,22, CLI: save evlog get evlog settings This command displays the current event log control settings.
EmulationEngine 11a/b/g User's Guide : enable/disable Example: CMC_EE -> set evlog file enable set evlog level This command sets the level at which events are logged. The verbosity level sets an “importance” threshold for events: at lower verbosity, only more “important” events are logged; at higher verbosity, less important events may also be logged.
Communication Machinery Corporation (CMC) get pmmode -- Get Power Management Mode get power -- Display Transmit Power Setting get psinterval -– Get Power Save Interval get rate -- Display Data Rate get sntpserver -- Display SNTP/NTP Server IP Address get station -- Display Station Status get systemname -- Display the EmulationEngine system name get telnet -- Display Telnet Mode get tzone -- Display Time Zone Setting get uptime -- Display UpTime help -- Display CLI Command List history -- Display the comman
EmulationEngine 11a/b/g User's Guide association (get) This command shows a list of known stations and their association status. This list will include the master station, the System Under Test, and all virtual stations. get association Example: CMC_EE -> get association AID vSTA DEV MAC Address SUT wlan0 00:04:E2:37:E6:A1 1 1 wlan0 00:0B:16:57:00:01 2 2 wlan0 00:0B:16:57:00:02 State Up Associated Associated channel (get) This command displays the radio channel/frequency used by the EmulationEngine.
Communication Machinery Corporation (CMC) countrycode (get/set) get countrycode This command displays the country code that is currently configured in the EmulationEngine. get countrycode Example: CMC_EE -> get country code Country Code: US - UNITED_STATES set countrycode This command sets the country code configuration parameter for the EmulationEngine. set : An ISO standard country code (e.g., DB - DEBUG, NA - NO_COUNTRY_SET, PR - PUERTO_RICO, US - UNITED_STATES, etc.
EmulationEngine 11a/b/g User's Guide EmulationEngine hardware. The address can be changed to any valid nonbroadcast or non-multicast MAC address. If you use multiple EmulationEngine's at your facility, each should have a WLAN MAC whose prefix is unique. For example, on the first EmulationEngine, use WLAN MAC Address: 04:0d:e0:62:23:57 and on the second EmulationEngine, use WLAN MAC Address: 06:0f:14:62:32:a0.
Communication Machinery Corporation (CMC) Example: CMC_EE -> get eemask WLAN Address Mask: ff:ff:ff:ff:00:00 CMC_EE -> set eemask This command sets the Wireless LAN Address Mask: set eemask : a valid address mask (e.g., ff:ff:ff:ff:00:00) eestatus (get) This command displays a high-level summary of the EmulationEngine's current status.
EmulationEngine 11a/b/g User's Guide set factorydefault NOTE: The example with the get config command shows the EmulationEngine's factory default configuration. features (get/set) get features This command displays features that have been enabled by your authorization code: get features Example: CMC_EE -> get features Features: 802.11A, 802.11B and 802.11G CMC_EE -> See “802.11b/g Commands” below for additional commands that are available if your feature set includes 802.11B or 802.11G.
Communication Machinery Corporation (CMC) ftp This command can be used to update the EmulationEngine software using FTP. It can also be used to upload command files into the EmulationEngine file system (see the "exec" command). ftp : The IP address of the target host. The CLI will prompt for the following entries: Username: The user name required to access the remote file. Password: The password required to access the remote file. Remote File: The file name on the remote host.
EmulationEngine 11a/b/g User's Guide Example: CMC_EE -> get gateway Gateway's IP Address:10.1.35.1 (eecfg value) Gateway's IP Address:10.1.35.38 (Runtime - DHCP Configured) CMC_EE-> set gateway This command sets the EmulationEngine's default gateway IP address. set gateway : A valid IP address in ASCII dotted-decimal notation (nn.nn.nn.nn). hardware (get) This command displays the EmulationEngine hardware revision information.
Communication Machinery Corporation (CMC) set hwtxretries This command sets the maximum number of hardware transmit retries for standard 802.11 MAC protocol frames. set hwtxretries : 4...31 ipaddr (get/set) get ipaddr This command displays the EmulationEngine's IP address. get ipaddr Example: CMC_EE -> get ipaddr IP Address: 10.10.10.46 CMC_EE -> set ipaddr This command sets the EmulationEngine's IP address.
EmulationEngine 11a/b/g User's Guide del key get key This command displays an encryption key. get key Example: CMC_EE -> get key 1 Shared Key 1, size CMC_EE -> 40, 1234567890 set key This command sets an encryption key or default shared key.
Communication Machinery Corporation (CMC) set login This command sets the login user name. The login user name is a text string and can be up to 32 characters. Control characters are not permitted. set login Example: CMC_EE -> set login Your_User_Name Login Username: Your_User_Name CMC_EE -> password (set) This command sets the password that will be required to log in into the EmulationEngine command line interface and web-based user interface.
EmulationEngine 11a/b/g User's Guide set pmmode This command sets the EmulationEngine’s power management mode. set pmmode : active (always awake) or psave (Power Save: doze for the specified listen interval set by set psinterval). Default: active. When Power Management mode is set to “active”, the EmulationEngine will remain in the awake state at all times.
Communication Machinery Corporation (CMC) ** DO NOT REMOVE POWER FROM THE EmulationEngine! ** Wait for the EE to update the configuration file in Flash ** or use the "reboot" command for immediate update & reboot. ** Automatic update will be done within one minute. ** CMC_EE -> CMC_EE -> ...Configuration file update completed. get power TransmitPower: half (-3 dB) Current Transmit Output Power 18 dBm CMC_EE -> psinterval (get/set) get psinterval This command displays the power save interval.
EmulationEngine 11a/b/g User's Guide Example: CMC_EE -> get rate Data Rate: best CMC_EE -> set rate This command sets the EmulationEngine data rate. Available selections will be different depending on the current wireless mode: 802.11a, 802.11b, or 802.11b. When you choose the best rate, the EmulationEngine attempts to deliver unicast data packets at the highest possible optimum data rate.
Communication Machinery Corporation (CMC) get sntpserver set sntpserver This command sets the SNTP server address. If an SNTP server address is configured, the EmulationEngine will attempt to retrieve the time from that server during initialization. set sntpserver : The IP address of the SNTP server. station (get) This command displays the status of an 802.11 STA from the EmulationEngine’s station information base. This command is intended for diagnostic purposes.
EmulationEngine 11a/b/g User's Guide time (set) This command sets the current system time. set time
Communication Machinery Corporation (CMC) version. Use "get version" to show the version of the configuration file stored in Flash. CMC_EE -> version CMC_EE -> get version Example: CMC_EE -> version Communication Machinery Corporation EmulationEngine(tm) 11a/b/g Rev 2.2.2 a@ab:C:/WLANLoadEmulator/src/ap/os/vxworks/target/proj/ap-ppc May 1 2003, 17:02:39 CMC_EE -> CMC_EE -> get version EE Cfg Rev: 2 CMC_EE -> 802.11b/g Commands The following commands are only available when the wireless mode is set to 802.
EmulationEngine 11a/b/g User's Guide ctsmode (get/set) These commands are used to get (display) and set CTS protection mode. 802.11 is a "listen and wait" protocol (CSMA/CA or collision avoidance) that requires the airwaves to be clear before transmission. Because 802.11b and 802.11g use different modulation schemes (CCK for 11b and OFDM for 11g), the RTS/CTS mechanism can be used to allow 11b and 11g devices to communicate.
Communication Machinery Corporation (CMC) set ctstype (11g only) When CTS mode is enabled (always or auto), this command sets the CTS type: set ctstype : cts-only = before transmission the EmulationEngine will transmit a CTS frame or rts-cts = transmission will follow an RTS/CTS frame exchange. shortpreamble (get/set) The preamble is a field in the 802.11 header. An 802.11b or 802.11g frame format can use a Short or Long preamble (Short = 56 bits, Long = 128 bits).
EmulationEngine 11a/b/g User's Guide Administrative Mode Commands The following commands are only available in administrative mode in the Command Line Interface. They are not available in user mode or in the EmulationEngine's web-based user interface. !WARNING!: Do not use these commands unless instructed to do so by an EmulationEngine engineer.
Communication Machinery Corporation (CMC) command is not case sensitive. The administrative mode password that is required to successfully execute this command is also case sensitive. basic11g (get/set) get basic11g (11g only) This command displays the current setting of 802.11g wireless mode basic rates: get basic 11g Example: CMC_EE -> get basic11g Basic Rate Set (11g): (1, 2, 5.5, 11) CMC_EE -> set basic11g (11g only) This command sets the basic rates to be used in 802.11g wireless mode.
EmulationEngine 11a/b/g User's Guide CMC_EE -> ...Configuration file update completed. bootrom This command can be used to update the EmulationEngine boot ROM image. bootrom When you enter this command, you will be prompted to confirm execution of this command: Updating boot firmware with a flat binary file bootrom*.
Communication Machinery Corporation (CMC) : A valid IP address in ASCII dotted-decimal notation (nn.nn.nn.nn). ls This command lists the files in the EmulationEngine's flash file system. CMC_EE -> ls Example: CMC_EE -> ls Directory listing of ".": 2/18/2003 17:12:24 1009597 12/01/2002 9:03:32 12/06/2002 11:03:06 1/21/2003 14:06:00 598 3/05/2003 12:27:24 598 11/21/2002 8:33:02 11/21/2002 10:01:36 4 directories, 5 files 1839104 bytes free EE22.
EmulationEngine 11a/b/g User's Guide arp = Toggle ARP debug trace function show = Display EE debug trace status NOTE: If you are running a log generator tool, do not enable "trace all”. This will cause numerous “printf” statements to be generated in the background and the EmulationEngine will malfunction. watchdog (get/set) get watchdog This command displays the current watchdog setting. CMC_EE -> get watchdog Watchdog: Enabled set watchdog This command enables/disables the system watchdog.
Communication Machinery Corporation (CMC) A suitable static IP address must be assigned to the EmulationEngine in accordance with network policy at your facility. Each EmulationEngine must have its own IP address. If you use multiple EmulationEngine's at your facility, each should have a WLAN MAC whose prefix is unique. For example, on the first EmulationEngine, use WLAN MAC Address: 04:0d:e0:62:23:57 and on the second EmulationEngine, use WLAN MAC Address: 06:0f:14:62:32:a0.
EmulationEngine 11a/b/g User's Guide CMC_EE -> set vsta 1 keyindex 1 CMC_EE -> OK CMC_EE -> get vsta 1 vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ...
Communication Machinery Corporation (CMC) 6-62 !" Select/highlight Internet Protocol (TCP/IP). !" Click the Properties button to display the Internet Protocol (TCP/IP) Properties dialog.
EmulationEngine 11a/b/g User's Guide !" 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. !" Click “OK” to close the Internet Protocol (TCP/IP) Properties dialog. !" Click the Close button in the Local Area Connection Properties dialog.
Communication Machinery Corporation (CMC) System date & time: THU JAN 01 00:00:20 2004 Use the "set date" or "set time" command to adjust EmulationEngine 11a/b/g software version 2.3.0.a1 WLAN mode .................... 802.11a WLAN MAC address ............. 00:02:8a:b6:1e:c9 WLAN address mask ............ ff:ff:ff:ff:00:00 LAN MAC address .............. 00:0b:16:00:00:57 BSSID of System Under Test ... 00:04:e2:38:a7:9c EE-SUT connection status .....
EmulationEngine 11a/b/g User's Guide Movement & Search Commands In the following commands, the default value for “n” is 1 nG: Go to command number n (e.g., 2G = go to command number 2) /s: Search backward in history for string s (e.g., /stats = search backward for "stats") ?s: Search forward in history for string s (e.g., ?stats = search forward for "stats") n: Repeat last search. N: Repeat last search in opposite direction. nk or n-: Get nth previous shell command in history.
Communication Machinery Corporation (CMC) Editing Commands In the following commands, the default value for n is 1 nrc: Replace the following n characters with c. nx: Delete n characters starting at cursor. nX: Delete n characters to the left of the cursor. d SPACE: Delete character. dl: Delete character. dw: Delete word. dd: Delete entire line. d$ or D: Delete everything from cursor to end of line. p: Put last deletion after the cursor. P: Put last deletion before the cursor. u: Undo last command.
EmulationEngine 11a/b/g User's Guide CHAPTER 7: The Programming Interface (Perl) The CMC Perl Software Developer Kit (SDK) is a set of perl modules which provide an application programming interface to the CMC EmulationEngine(tm) family of products.
Communication Machinery Corporation (CMC) 7-2 080104
EmulationEngine 11a/b/g User's Guide CHAPTER 8: Event Logging Overview During normal operation, the EmulationEngine processes and can log various types of events. When an event is logged, a record of the event is stored for future analysis. The event record includes a timestamp, an indicator of the type of event that occurred, and a limited amount of data to describe the event.
Communication Machinery Corporation (CMC) [optional parameters] describe the specific circumstances of this particular occurrence of the event. It can be up to four 32-bit parameters. Example: pDesc 0x9326c0 hwStatus 01cd803c:0be20203 numRxDesc 9643712. Example: 12/27/2002,9:59:57,2296.
EmulationEngine 11a/b/g User's Guide CHAPTER 9: Statistics Counters The statistics counters defined in this chapter can be: 1) Selected when creating a new monitor in the Monitoring/New Monitor dialog. 2) Displayed as legends or table headings in a monitor or reports page. 3) Displayed using CLI commands. Individual Virtual Station Counters If statistics for individual virtual stations are selected, one or more of the following values may be shown. Individual Virtual Station 802.
Communication Machinery Corporation (CMC) Individual Virtual Station Ping Statistics These counters are only shown if the virtual station was configured for internal mode: Transmit Count: Number of Pings the virtual station is configured to send Transmit Data Size: Size of the data payload in the ICMP Echo message Packets Transmitted: Number of ICMP Echo packets that have been transmitted Bytes Transmitted: Number of data bytes that have been transmitted in ICMP Echo packets Transmit ENOBUFS: Number of tim
EmulationEngine 11a/b/g User's Guide FCS_Fails: Frame checksum errors in received frames WEP_Excluded: Received frames that were rejected because of incorrect encryption Summary Statistics Summary statistics provide a summary report taken over a set of virtual stations. The virtual station set can be a defined group or all virtual stations currently in the system. In contrast, the individual virtual station statistics report provides a list of statistics and counters for an individual virtual station.
Communication Machinery Corporation (CMC) TxDataMax: Maximum data frames transmitted per virtual station TxDataAvg: Average data frames transmitted per virtual station TxDataFrames: Total data frames transmitted by all virtual station TxMcastMin: Minimum Multicast frames transmitted per virtual station TxMcastMax: Maximum Multicast frames transmitted per virtual station TxMcastAvg: Average Multicast frames transmitted per virtual station TxMcastFrames: Total Multicast Frames transmitted by all virtual stat
EmulationEngine 11a/b/g User's Guide RxMcastMax: Maximum Multicast frames received per virtual station RxMcastAvg: Average Multicast frames received per virtual station RxMcastFrames: Total Multicast Frames received by all virtual stations RxMgmtMin: Minimum Management Frames received per virtual station RxMgmtMax: Maximum Management Frames received per virtual station RxMgmtAvg: Average Management Frames received per virtual station RxMgmtFrames: Total Management Frames received by all virtual stations Rx
Communication Machinery Corporation (CMC) 9-6 080104
EmulationEngine 11a/b/g User's Guide CHAPTER 10: Troubleshooting Login Name and/or Password Recovery If configuration records for your EmulationEngine are lost and you do not remember its user name or password, it may not be possible to log in to the device. If this should happen, a special login sequence will direct the EmulationEngine to reset the login name and password to their factory defaults.
Communication Machinery Corporation (CMC) If this dialog is displayed, complete the following steps: !" Select Internet Options from the Tools menu in Internet Explorer. !" Select the General tab in the Internet Options dialog. !" Click the Settings... button in the Temporary Internet Files section of the dialog. !" In the Settings dialog, make sure the “Every visit to page” radio button is selected under “Check for newer versions of stored pages”.
EmulationEngine 11a/b/g User's Guide cable or through a hub/switch using a straight cable. If the LED remains OFF, check the cable connections. If the LED remains OFF, one or more of the following problems may exist: !" Incorrect or defective cable !" Defective hub/switch !" Using the wrong port on a hub/switch (i.e.
Communication Machinery Corporation (CMC) Loading Files from the Command PC If you attempt to load a scenario file from the command PC using the web-based user interface, the browser may display the following warning dialog: Missing Key File 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.11a, 802.11b, and 802.11g.
EmulationEngine 11a/b/g User's Guide EmulationEngine(tm) 11a/b/g Rev 2.3.0.a1 System date & time: THU JAN 01 00:00:20 2004 Use the "set date" or "set time" command to adjust EmulationEngine 11a/b/g software version 2.3.0.a1 WLAN mode .................... 802.11a WLAN MAC address ............. 00:02:8a:b6:1e:c9 WLAN address mask ............ ff:ff:ff:ff:00:00 LAN MAC address .............. 00:0b:16:00:00:57 BSSID of System Under Test ... 00:04:e2:38:a7:9c EE-SUT connection status .....
Communication Machinery Corporation (CMC) Configuration Records Print this page and use the following form to keep a record of EmulationEngine configuration parameters: Parameter Default CLI Command IP address 192.168.0.50 set ipaddr Subnet mask 255.255.255.0 set ipmask Gateway 192.168.1.
EmulationEngine 11a/b/g User's Guide APPENDIX A: Specifications Hardware Standards: IEEE 802.3, 802.3u, 802.1d, 802.11a, 802.11b, 802.11g Ports: !" (1) 10/100Base-T Ethernet, RJ-45(UTP) !" (1) RS-232 (DB9) !" (1) Power - 5V DC, 2.5A Frequency Range: 802.11a: 5GHz Unlicensed National Information Infrastructure (UNII) band, 802.11b/g: 2.4 GHz band.
Communication Machinery Corporation (CMC) 802.11b/g: 1 (2.412), 2 (2.417), 3 (2.422), 4 (2.427), 5 (2.432), 6 (2.437), 7 (2.442), 8 (2.447), 9 (2.452), 10 (2.457), 11 (2.462). Software EmulationEngine Core: !" IEEE 802.11a, 802.11b, 802.11g !" Maximum number of vSTAs: 64 Performance: !" Average Latency per frame (uSec) at 54 Mbps: EmulationEngine-to-SUT: minimum 263, maximum 609, average 279. SUT-to-EmulationEngine: minimum 279, maximum 574, average 315.
EmulationEngine 11a/b/g User's Guide Performance NOTE: All performance data was collected in an open air enterprise environment. Performance results may vary depending on the device being tested as the EmulationEngine assesses the entire System Under Test (SUT). 802.11a Throughput per vSTA per Packet Length: External Mode 64 Bytes 3.15 128 Bytes 5.88 256 Bytes 10.53 512 Bytes 17.52 1024 Bytes 26.29 1280 Bytes 28.81 1518 Bytes 30.89 SUT-to-EmulationEngine 1 vSTA 2.71 5.19 9.38 15.97 24.58 26.
Communication Machinery Corporation (CMC) 64Bytes 128Bytes 256Bytes 512Bytes 1024Bytes 1280Bytes 1518Bytes Maximum 802.3 rate with WebBased User Interface 0.51Mbps 0.80Mbps 1.61Mbps 2.59Mbps 4.28Mbps 4.30Mbps 5.08Mbps 1000pps 781pps 781pps 634pps 523pps 420pps 419pps 802.11 Theoretical unidirectional @11Mbps (short preamble) 0.70Mbps 1.31Mbps 2.34Mbps 3.85Mbps 5.71Mbps 6.32Mbps 6.
EmulationEngine 11a/b/g User's Guide APPENDIX B: Software Upgrades Complete the following steps to load a new software file into the EmulationEngine’s flash file system: 1) If you are already logged in to the CLI, type reboot to return the EmulationEngine to a known state: reboot 2) Use Telnet to log back in to the CLI: telnet 192.168.0.50 EE login: Admin Password: EE EmulationEngine Rev x.x CMC_EE -> This step uses the EmulationEngine’s default IP address (192.168.0.50).
Communication Machinery Corporation (CMC) # done 1007441 bytes CMC_EE -> 8) When the transfer is complete, use the "ls" command to verify that the size of the file in Flash is the same number of bytes as the file on the FTP server/command PC. CMC_EE -> ls 9) At the CMC_EE-> prompt, type the following command to move the file and use the correct boot name. CMC_EE -> mv EE22NEW.SYS EE22.SYS 10) When the move is complete, use the "ls" command to verify the file has been moved with the correct name.
EmulationEngine 11a/b/g User's Guide APPENDIX C: Cable Pin Assignments Standard Ethernet Cable A straight cable can be used to connect the Command PC to a hub and the hub to the EmulationEngine For a straight cable; the wires match one for one. This cable is not provided. Pin 1: Rx+ Pin 2: RxPin 3: Tx+ Pin 4: Not Used Pin 5: Not Used Pin 6: TxPin 7: Not Used Pin 8: Not Used Ethernet Cross-Over Cable A cross-over cable must be used to connect the Command PC directly to the EmulationEngine.
Communication Machinery Corporation (CMC) male connectors. In this table, DTE refers to the local/EmulationEngine side of the connection and DCE is the remote side.
EmulationEngine 11a/b/g User's Guide APPENDIX D: Error and Status Messages The EmulationEngine CLI may display the following error and status messages in response to incorrect or unexpected user actions or WLAN activity. EmulationEngine or Virtual Station Control Messages EE Lost SUT (no beacons): The EmulationEngine was joined with the System Under Test but has stopped receiving beacons from it.
Communication Machinery Corporation (CMC) MLME Already in BSS: Internal error - a requested MLME function was rejected because the EmulationEngine is already a member of a BSS. MLME Driver error: Internal error - an MLME function has encountered an unspecified error in the device driver. MLME Op not supported: Internal error - an MLME function has been invoked which is not supported in the current configuration.
EmulationEngine 11a/b/g User's Guide Index 8 802.
Communication Machinery Corporation (CMC) bssid (set) bsslist (get) channel (get) conf config (get) countrycode (get/set) date (set) deauth disassoc eestatus (get) evlog (save) evlog (set) evlog buffer (clear) evlog buffer (get) evlog console (set) evlog file (clear) evlog file (get) evlog file (set) evlog level (set) evlog module (set) evlog settings (get) exec factorydefault (set) frequency (get) ftp gateway (get/set) group (del(ete)) group (get) group (reset) group (set) group stats (clear) group stats
EmulationEngine 11a/b/g User's Guide station (get) summfile group (del(ete)) summfile group (get) summfile vsta all (del(ete)) summfile vsta all (get) systemname (clear/get/set) telnet (get) time (set) timeofday tzone (get/set) uptime (get) version (get) vsta (del(ete)) vsta (get) vsta (reset) vsta (set) vsta all summary (save) vsta stats (clear) vsta stats (save) 6-50 6-31 6-32 6-31 6-32 6-50 6-50 6-51 6-51 6-51 6-51 6-52 6-23 6-23 6-27 6-28 6-28 6-23 6-28 Command Line Interface (CLI) 6-1 Command PC S
Communication Machinery Corporation (CMC) Polling Timeout Power Save Mode Reboot Receive Parameters Reconnect Reset Status Transmit Parameters Transmit Power Virtual Station Status Wireless Mode Encryption Defaults Keys Mode 10-3 5-40, 6-46 5-42, 6-49 5-35 5-41 5-42 6-40 5-36 5-40 6-50 5-39 5-58 5-30, 6-12, 6-44 5-29, 6-12, 6-24 Ethernet Compatibility 1-4 Ethernet Connector 2-2 Event Log Clear CLI Commands Configuration Controls/Configuration Display Export Modules Record Format Verbosity Level Exter
EmulationEngine 11a/b/g User's Guide I Installation Internal Mode Interval EmulationEngine Polling Monitor Update IP Address Iteration 3-1 5-5, 5-25, 6-12, 6-15 5-35 5-50 6-42, 6-44 5-15, 5-26, 5-27, 5-60 L Layer 2 Frame Capture 5-25, 6-12, 6-21, 6-30 Layer 3 Frame Capture 5-25, 6-12, 6-21, 6-30 LEDs Ethernet LED Off Status at Installation 2-1 2-2 10-2 Load Profiles Logging CLI Commands Login 5-18, 5-20 6-32 6-1 M Menus Edit File Group Options Reports Scenario vSTA 5-60 5-66 5-64 5-67 5-69 5-68
Communication Machinery Corporation (CMC) P Password Recovery 6-1, 6-46 10-1 Persistence 5-27 Ping Configuration 5-59 Polling Interval 5-12, 5-35 Polling Timeout 5-12, 5-36 Power Save Interval Power Save Mode Power Supply Connector Preferences 6-48 5-40, 6-46 2-2 5-60 R Radio Channel/Frequency Radio Frequency Reboot Reports EE Configuration Export Group Summary Master Station Scenario Summary Templates Virtual Station Detail RJ-45 Ethernet Connector RTS Threshold per vSTA 6-37 6-41 5-42, 6-49
EmulationEngine 11a/b/g User's Guide Signal Counters Virtual Stations 9-2 6-23, 9-1 Statistics Summary 9-3 Status/Error Messages D-1 System Name System Requirements System Under Test BSS List Changing CLI Commands Join Scan Select System Under Test 6-50 1-3, 5-1 6-5 6-4 6-4 5-9, 5-34, 6-6 5-19, 6-6 5-3, 5-33 T Test Clock Test Toolbar 5-13 5-13, 5-61 Time Zone 6-51 Toolbars 5-60 Traffic Types Transmit Power 5-24 5-40, 6-47 Transmit Retries 6-43 U User Interface Configuration User Name 5-6
Communication Machinery Corporation (CMC) Traffic Types Transitional States 5-25, 6-12, 6-15 5-60 W Web-Based User Interface 5-1 Welcome Screen 5-2, 5-60 Wireless Mode 5-33, 6-8 Index-8 080104
EmulationEngine 11a/b/g User's Guide EmulationEngine, vSTA, EEAnalyst and EEScenario are trademarks of Communication Machinery Corporation. Copyright © 2004 Communication Machinery Corporation, all rights reserved. Patent Pending No.