Motorola EWB100 Usage and Deployment Guide Rev 1.7 EWB 100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Revision History................................................................................................ 10 1 2 3 4 Introduction .................................................................................................. 12 1.1 The EWB100 ........................................................................................ 12 1.2 This Document .....................................................................................
Motorola EWB100 Usage and Deployment Guide 5 Rev 1.7 4.8.5 stat................................................................................................. 21 4.8.6 notify .............................................................................................. 22 4.8.7 cfg.................................................................................................. 22 4.8.8 version ........................................................................................... 22 4.8.
Motorola EWB100 Usage and Deployment Guide 6 7 IP Stack ....................................................................................................... 31 6.1 Basic Functionality ................................................................................ 31 6.2 Configuration Commands ..................................................................... 31 6.2.1 Network Mode ............................................................................... 32 6.2.
Motorola EWB100 Usage and Deployment Guide 8.3 9 Rev 1.7 UC Command Reference ..................................................................... 42 Profiles ......................................................................................................... 43 9.1 Introduction to Profiles .......................................................................... 43 9.2 Profile Initialization ................................................................................ 46 9.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.2.2 Packages ....................................................................................... 61 13.2.3 Package and File Headers ............................................................ 62 13.2.4 Tools to build file headers.............................................................. 62 13.3 Using Airbeam ...................................................................................... 63 13.3.1 Enabling the Airbeam Function .
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.5.22 Airbeam Download Timeout ....................................................... 70 13.5.23 Cradle Wait Time ....................................................................... 71 14 MSP Support ............................................................................................ 72 14.1.1 MSP Mode ..................................................................................... 72 14.1.2 MSP Default Mode ...................
Motorola EWB100 Usage and Deployment Guide 17.3.2 18 Rev 1.7 Port ................................................................................................ 85 Obtaining Device Status Information ........................................................ 86 18.1 Basic Concepts ..................................................................................... 86 18.2 LED Blink Patterns ............................................................................... 86 18.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.19 Deployment Counters .............................................................. 100 18.6.20 WTT Counters.......................................................................... 100 18.6.21 Unicast Counters ..................................................................... 102 18.6.22 DNS Counters and table .......................................................... 103 18.6.23 Configuration Counters ................................
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Revision History Revision Description Editor 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 1 Introduction 1.1 The EWB100 The EWB100 is a compact Voice over wireless LAN (VoWLAN) communications device designed to operate throughout the wireless local area network of an enterprise environment. The EWB 100 provides Push-to-Talk style communications, similar to any normal Push-to-Talk radio. EWB100 badges enable instant employee accessibility through a simultaneous call to a group of workers and a person-to-person reply call from a group member.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 2 EWB100 User Overview 2.1 The Physical Device The image below shows the EWB100 with the important user elements identified 2.2 The User Interface The user interface of the EWB100 is very simple, consisting of 5 buttons,a tricolor LED, a microphone, and a speaker. There are also optional headsetsthat can substitute for the microphone and/or speaker. There is not a screen of any type.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The second mechanism is by multiple button sequences. At this time only two button sequences are used but potentially there could be three and four button sequences but they would be very awkward to use. There are currently 3 two button sequences defined: • PTT + FAPP => Power off • PTT + SAPP => Status/configuration • VOLDN + SAPP (while in the cradle) => set to factory defaults The LEDs are used mostly to indicate general device state.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 3 Internal Elements of the EWB100 This section introduces some of the more important internal aspects of the EWB100 as well as some features beyond just the voice modes mentioned in the previous section. 3.1 Two software subsystems There are two software systems that run on the EWB100 device. The first is the “mini-kernel” or “boot loader” which runs right after power on or reset.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 3.6 Profiles A profile is a set of configuration variables that control the user interface and overall functionality of a EWB100 device. Different profiles are simply different sets of the same configuration variables. Profiles define what functions are associated with particular buttons, the alerts and notifications associated with UI events, walkie talkie channels, etc. Virtually all user visible configuration parameters are part of a profile.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 4 The Command Line Interpreter 4.1 Basic Concepts The CLI on the EWB100 is used for a wide variety of functions including configuration, updates, diagnostics, and maintenance. Its primary use, though, is for configuring the device. The interface is very simple; it features one line commands consisting of a key word and zero or more parameters. Most commands take effect immediately.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 configuration information from a remote server even if the current configuration has been corrupted. The “existing” configuration can be deleted and the “user defined defaults” will be used to access the update server. 4.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Most input parameters can be shortened to the minimally unique string. Hence: • “set” can be “se” • “statistics can be “st” • “key” can be “ke” or even “k” The key to using to the shortened format is that what is entered must be unique among the possible options for the command. 4.4 CLI Access Control 4.4.1 Basic Concept A password may be defined that will control access to the CLI via all mechanisms.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 4.5 Encrypted Configuration Parameters Certain Configuration Parameters may be sent to the device in an encrypted form that uses AES encryption. The parameters are: • • • WPA Passphrase and User Default WPA Password WPA Key and User Default WPA key Airbeam Password and User Default Airbeam Password This mechanism allows sensitive information to be placed into CLI files without a concern that the information will be compromised. 4.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 4.8 CLI Commands Commands There are the following commands in the runtime software CLI: set show stat system notify roam cfg help clear ping version : : : : : : : : : : : set configuration show configuration system status system control performs a notify op roam History configuration operations display general user interface help clear stats ip ping version of software 4.8.1 set This command is used to assign values to various configuration parameters.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 list of counters (simple incrementing values), statistics (values that have been computed based upon various internal variables), or the contents of tables that have been built dynamically 4.8.6 notify This command is used to play various audio phrases and to control the 3 LEDs. There are between 3 and 10 parameters associated with this command.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5 802.11 Interface 5.1 Basic Radio Functionality The following describes the 802.11 related features of the EWB 100. • It is an 802.11 b/g compatible device. As such it operates only in the 2.4GHz band. • It supports operation on channels 1-11 in the US and 1-14 on a worldwide basis. By default it will assume channels 1-11 are operational. For operation on other channels, contact Motorola support.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 • The device operates primarily in PSP mode, even during voice packet transfers. As such the EWB is very sensitive to variations in Beacon delivery times. If an infrastructure is configured to support multiple BSS, the one the EWB uses should be the first one if secondary ones experience significant variability in delivery times.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5.2.3 Security modes This command defines the acceptable security modes for the radio. The format is: set radio security xyz Where xyz is a string that defines the target security mode. Acceptable values are: • none • wep 64 (40 bit wep) • wep128 (128 bit wep) • tkip • aesccmp The default is “none” 5.2.4 User Default Security Mode This command sets the “user default” security mode.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5.2.7 WPA Password This command sets the WPA/WPA2 PSK Password . The format is: set radio password xyz Where xyz is the password string. It may range from 8 to 63 ASCII characters. This password must be set only after the ESS for the device has been specified. This parameter cannot be displayed after being entered. There is no default value for this parameter 5.2.8 User Default WPA Password This command sets the “user default” wpa pasword.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5.2.12 User Default WPA key This command sets the user default security key when TKIP or AESCCMP are used. It contains 64 hex digits to create the 256 bit key. The command is set radio defwpakey xyz Where xyz is the security key. There is no default value for this parameter. 5.2.13 Encrypted WPA key This command sets the security key when TKIP or AESCCMP are used. It contains 64 hex digits to create the 256 bit key.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5.2.16 Deltarssi One of the triggers for a scan is that the received RSSI drops below a certain threshold. This command specifies the threshold. The command is: set radio deltarssi n The default value is 10. Where n is the RSSI threshold. Like minRssi it is specified as a positive, decimal value and is converted to a negative number internally. When displayed, it will also be displayed as large positive number. 5.2.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 5.2.20 roamRssi One of the triggers for a scan is that the received RSSI drops below a certain threshold. This command specifies the threshold. The command is: set radio rssiavg n The default is -65dbm Where n is the RSSI threshold. Like minRssi it is specified as a positive, decimal value and is converted to a negative number internally. When displayed, it will also be displayed as large positive number. 5.2.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The default is 0xe0 (ie. All rates about 24 mbits are not requested during association. It should be noted that the EWB100 can use any rate supported by the AP. This command simply limits what rates the AP can use to send to the EWB100 device. 5.2.23 Cradle low power mode If sitting in the cradle, the device will scan for new APs less often when in the cradle than when not in the cradle.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 6 IP Stack 6.1 Basic Functionality This section describes the functionality of the TCP/IP stack within the EWB100. • The EWB supports only IPv4. • The EWB supports three mechanisms for obtaining IP addressing information: Static, “MAC”, and DHCP. The factory default is “MAC” in which the lower 24 bits of the IP address is taken from the lower 24 bits the MAC address. The upper 8 bits of the IP address with MAC mode is 192.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 6.2.1 Network Mode This command specifies how the TCP/IP stack will acquire an IP address. The format is: set network mode xxx Where xxx is may be dhcp, static, or mac. If DHCP, the device will obtain IP addressing information using DHCP. If static, then the user must enter the IP address, mask, and default gateway manually using the commands in this section. If MAC, then the IP address is the 192.x.y.z where x.y.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 6.2.6 DNS Server IP Address This command specifies the IP address of the DNS server for the device. It is required if Static mode is selected and DNS service is required. The format is: set network dns a.b.c.d The default is: 192.168.0.1. Where a.b.c.d is the ip address of the DNS for the device. If DHCP is selected, it is supplied as part of the DHCP response and this entry will be ignored. 6.2.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 This feature is present to fix problems with roaming on Cisco 4400 network products that expect a DHCP on each roam. This function is controlled by the following configuration bit in the “misc new2” command: The bit value is: 0x0080 The default is disabled. 7 Walkie Talkie 7.1 Basic Concepts One of the primary features of the EWB100 is the “walkie talkie” like voice capability.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 At the end of a WTT session, a user will typically hear two beeps. The first is indicates either the termination of the existing WTT session or the return to home channel. The second indicates the termination of the Private Reply setup period, the operation of which is described in the next section. 7.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 • There is a mechanism to resolve possible contention among sending stations. “Collisions” are resolved within 400ms and should not be noticed by users. • There is an upper bound of 30 seconds on voice sessions. Sessions longer than will be automatically terminated. The maximum duration may be changed by a configuration command. 7.3 Alternative Channels As noted above, normally an EWB100 is configured to transmit WT voice streams on a single channel.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 repeating the button action that triggered the change. After any of these events occur, the device will switch back to the default channel after the timeout period. In the second mode, the device will stay on the alternative channel until the user requests to go back (by repeating the button action that triggered the change) or by the expiration of a configuration defined timeout. The user may make any number of WTT sessions on the alternative channel.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 7.5.1 Zero channels (WTT disabled) Disable WTT enable in the profile. Doing this makes the EWB100 a rather useless device in that the WTT functionality is disabled. 7.5.2 One channel Program the pttkeydata field in user profile 0. Also set the wttrxmask parameter in the profile.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 7.5.4 Two channels – equally used – listen on both In this option, there are two channels that the user typically stays on for a long time. It could be two departments or two job related channels. The time on a channel can be minutes or hours. The user wants to listen on both channels all the time.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The command sequence is below where x and y are the two channels set pr key ptt 0 wtt set pr data ptt 0 x set pr key sappsc 0 pr set pr rxwttmask 0 z (where z = (1 << (x-1) ) ) set pr key ptt 1 wtt set pr data ptt 1 y set pr key sappsc 1 pr set pr rxwttmask 1 z (where z = (1 << (y-1) ) ) set mis new2 k where k includes the bits of the mask 0x40 7.5.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 8 Private Reply/Unicast Voice 8.1 Basic Concepts In addition to the multicast Walkie Talkie like functionality present in the EWB 100, there is also the capability to do private 1 to 1 voice conversations. This capability is called “Private Reply”. The “Push to talk” modality is kept but the voice stream is only sent between two parties. They can have a “back and forth” session using the PTT button that will remain so long as the session is maintained.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 When either side terminates the session (or it times out), a SIP “END” packet will be sent and the session will be terminated on both sides following one or more additional packets. The voice stream is half duplex, being controlled by the SIP handshakes. Voice packets are in a compressed format using G729 every 100ms and so contain 100 bytes of voice plus approximately 50-60 bytes of IP, UDP, and RTP headers.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 9 Profiles 9.1 Introduction to Profiles Profiles are a means to change a large number of configuration parameters for the device in a single step. Most of the user visible configuration parameters are set on a per-profile basis; when one switches profiles, one can change many configuration parameters at once.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 With either approach, the selected profile may become the “default” profile if so enabled by the configuration. If so enabled, the device will remember the last profile selected across resets. If this mode is not set, then the device will revert back to the default profile upon a reset. As noted above, this profile 0 by default.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 General device functions enable/disable/configure various functions.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Configuration for audio and LED prompts allow a user to change the audio prompt for a function as well as the LED blink pattern. All of the audio alerts a user can hear can be replaced by another audio sequence. One can use this capability to establish novice/expert based prompts or change the language of the prompts.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 9.3.1.2 Name This parameter assigns an ASCII string name to the profile. This name is not used for any purpose except when the distributed name directory function is used. It can consist of any ASCII character and must be between 1 and 16 characters. The format is: set profile name n y Where n is the profile number (0-7) and y is the ASCII string. The default is the channel number. 9.3.1.3 Voice Prompt This parameter assigns an alert to the profile.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 9.3.1.7 Channel Listen Mask This parameter defines the WTT channels that the EWB100 device listens upon. It is a 32 bit number in which the bit numbers correspond to WTT channels. The format is: set profile rxwttmask n y Where n is the profile number (0-7) and y is a 32 bit hex number.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 24 800000 25 1000000 26 2000000 27 4000000 28 8000000 29 10000000 30 20000000 31 40000000 32 80000000 Multiple bits may be set in the mask in order to allow the device to listen on multiple channels at once. This function is available only is if the scan enable parameter is enabled. The default is to listen on all 32 channels (mask = 0xffffffff). 9.3.1.8 Mute Enable This command enables the mute function for this profile.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 9.4 Key Usage These commands define the actions taken by various key operations for the profile. Each profile can assign different actions to the same key operation. All of the commands follow the following format.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 9.6 Alerts These commands assign entries from the phrasebook to particular profile alerts.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 • l4_L4 - alert for 4rd highest battery charge state (25%) • l5_L5 - alert for 3rd highest battery charge state (10%) • l6_L6 - alert for lowest battery charge state (5%) • nosignal - alert played for extended out of range state n is the profile number (0-7) z is an ASCII string that identifies an entry in the phrasebook. 9.7 Timeouts These commands define the timeout values for various actions and states within the profile.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 10 User Defined Default 10.1 Basic Concept User Defined Defaults allows users to alter the default values of various network, radio, and airbeam parameters. When the device is restored to “factory defaults”, these parameters will be loaded with values the user specifies rather than the factory defaults. Only those parameters needed to do an Airbeam update have user defaults.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 10.3 Showing User Defined Default Values The regular and user default parameters can be shown via the regular show configuration commands : • • • Show radio Show network Show airbeam To see the user defaults, user mode must be enabled (see above). Otherwise they are hidden. 10.4 Enabling User Defined Defaults User defined defaults must be enabled by a configuration command. The command is: set misc user enable/disable The default is disabled. 10.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 11 User Interface Customization 11.1 Basic Concepts Some aspects of the user interface may be altered by configuration settings. Some define the behavior of buttons while others control how the device behaves in certain situations. This section defines what may be changed and how to do it. 11.2 Out of range power down This command defines the behavior of the device if either an 802.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 11.6 Disable Clear Configuration Key Sequence If set, the capability to clear a configuration using a multiple key sequence is disabled. The function is controlled by the following configuration bit in the “misc new2” command: The bit value is 0x0800 The default is to enable the sequence. 11.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 11.10 Roam alert timeout This command defines the duration that the unit may not be associated with an AP before the “out of range” alert is played. This avoids alerts when association is lost for a short period of time. set misc roamalert n Where n is the time in seconds. The default is 10 seconds.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 12 Telnet There is a Telnet server present inside the EWB100 that allows remote access to the CLI. It is reachable using any Telnet client. It supports one client at a time. If the CLI requires a password, the user must enter the password before gaining access with Telnet. The Telnet interface is intended for “lightweight” usage such as setting variables or examining configuration or statistics.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13 Airbeam 13.1 Basic Concepts This section explains usage of Airbeam to update and configure the EWB100 The firmware/configuration update process is used for downloading new runtime code, configuration files, and audio clips to the device. It follows the “Airbeam” model that uses FTP to download “package” files that describe new runtime/configuration information that is be downloaded. In this document it will be termed the “airbeam” process.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 network status. It also contains the latest package number stored in the device. It is sent to a particular IP address. Hence by monitoring status packets a user can determine if a device has updated to the latest package. 13.2.2 Packages A Package is a concept taken from Airbeam and consists of a package file and one or more component files.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.2.3 Package and File Headers The package file and each component file begins with a 128 byte header made up of a number of parameters. Each parameter is tagged with a one character identifier and all fields are separated by commas. The header is in ASCII text. An example of a header is: I,EWB 100;Z,111;V,1829149732;B,6320080;C,b01e;N,7;S,342;D,05/04/10;T,11:10:51; This is how to decode the header.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Replace postCfg.txt with the file containing the cli commands. Replace postCfg.cli with your desired output file. You can add date and time as desired. 13.3 Using Airbeam The purpose of airbeam configuration is to supply information to the device so that it knows how to obtain the package file that it is to use. The device uses FTP for this purpose and so most of the commands are FTP related.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 This approach, while simple, can cause problems if the IP address of the FTP can change or is different for every site. A more flexible approach is to specify the DNS name of the FTP via the server parameter. The command is: set airb server ftp_dns_name where ftp_dns_name is the DNS name of the FTP server. When the name specified the EWB will make a DNS inquiry to obtain the DNS name to IP address mapping.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 will be written to flash memory and used for subsequent FTP requests. It will also be used as the IP address for the device status packet (described below). The device will then reset itself. The update and reset will take place only if the currently defined values of the two IP addresses in flash memory is not equal to the value contained in the option.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 where xx is a string that defines the user name. If not specified and by default, the device will use its MAC address as the user name. It will be a series of 16 hex digits without separation. The DA assumes that the username will be the MAC address but the device has more flexibility. The choice of whether to use a single username for all devices or not is a customer issue.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The best option depends on the customer needs. There is sufficient flexibility to handle many situations. Since the filename is a configuration option, the value may be changed during the configuration process. Hence one name might be used for initial deployment and then changed later on. Likewise each release may specify the name of the next release. 13.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.5.5 Airbeam FTP Port This command defiens the TCP port used to access the airbeam FTP server. set airbeam port_ab xx where xx is the TCP port number. It is a 16 bit decimal number. The default is: 50555 13.5.6 User Default Airbeam FTP Port This command is the user defined default version of the airbeam FTP port comand. The command is: set airbeam def_ab_port_ab xx 13.5.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.5.11 Airbeam user password This command specifies the user password for logging into the Airbeam FTP server. The command is: set airbeam password xx where xx is the user password. The default is “motorola”. 13.5.12 User Default Airbeam user password This command is the user defined default version of the Airbeam user password comand. The command is: set airbeam def_password xx 13.5.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.5.17 Airbeam package version This command specifies the latest airbeam package version. It is normally not set by users as the parameter is updated by the Airbeam subsystem during the deployment process. It may be used to force the reloading of a given package however. The command is: set airbeam pkg_ver xx where xx is the package version. 13.5.18 Airbeam bootloader/minikernel version This command specifies the latest minkernel package version.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 13.5.23 Cradle Wait Time When the device is inserted in the the cradle and the airbeam mode is enabled, it will access the Airbeam FTP serer to determine is a new package needs to be downloaded. This command specifies the delay between the insertion onto the cradle and the actual access of the airbeam server. This delay is needed to ensure that the battery has sufficient charge for the process.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 14 MSP Support The EWB100 supports MSP for configuration and firmware updates. Information MSP and how to use it to support the EWB100 is found in the MSP User Documentation. This section describes configuration commands for MSP There are two MSP configuration commands and they only allow MSP to be disabled. MSP can only be enabled via the MSP staging process. 14.1.1 MSP Mode This command disables the MSP client.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 15 Misc CLI Commands This section describes a number of CLI commands that are “standalone” and not associated with another subsystem. 15.1 Ping This command performs an ICMP ping. The format is: Ping [-x] [-t] [-c n] [-l m] [a.b.c.d] • a.b.c.d is the ip address of the target • -t indicates the ping is to be run continuously until stopped • -c n indicates that n pings are to be sent. If neither –t nor –c is specified, one ping will be performed.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 15.3 The Cfg Command This command modifies the state of the configuration subsystem. There are two possible parameters for this command: • default – clears the configuration database which effectively restores the device configuration to its default value. All profiles and directory entries are deleted. o If user defaults are enabled, this command will set the configuration parameters to the user defaults.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 15.7.1 For invoking notifications The command format is: notify l led pattern Where led is an led and can have the value: • green • red • blue Pattern defines the blink pattern used and can have the value: • on – always on • off – totally off • blink – one short blink • twice – two short blinks • slow – slow blink pattern • fast – flast blink pattern Each led can be given its own pattern.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 16 Audio Services 16.1 Introduction This document describes how EWB100 creates audio notifications (i.e. “alerts”) for the user. It will explain the underlying mechanisms as well as how the notifications can be altered. It will also explain how the mechanisms are used to provide Multilanguage support. 16.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 There are approximately 400 audio clips stored in the runtime image. This list of clips is called the Default Directory and includes: letters, numbers, status and configuration phrases, common phrases, various tone sequences, phrases for demo applications, etc. The Default Dictionary is basically a list of clip names. All the audio clips that the device needs to function are defined in the Default Dictionary.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The search of the clip tables to build clip-id is done at two different times. The first time is at startup when the device builds all the clip-id based on the Default Dictionary. For each name in the Default Dictionary, the device will search the available clip tables in order outlined above and build the clip-id. Hence any of the Default Dictionary clips can be overlaid by either Flash or Ram tables.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Changing the meaning of a default clip is the same as redefining a device wide clip and uses the same technique as describe above. Directory Entries are the names of users or channels that are defined in the directory. Typically such entries would be defined in the Flash or Ram tables, although a user might use clips in the default dictionary (there are some clips in the default dictionary for exactly this purpose). The directory is empty by default.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 There are a couple of limitations to the current implementation model. The first is global nature of the audio clips used for status and configuration purposes. One can overlay them into any single language one wants but multiple language support is not present. For example, the phrase “IP address 10.1.2.3” could be spoken in English or French but not both. Given that the most common use is for support, this may not be an issue.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 These additional prompts can go into the “special commands” function of the DA or in the regular configuration files if just using FTP with Airbeam packages. In addition to the configuration values the additional language prompts must have been loaded into the flash memory of the EWB100. At this time there is only one such file required and it supports all of the above languages. The file name is: euro_tts_flash_image.bin.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 17 Web Server 17.1 Basic Concepts EWB 100 supports creation of HTTP server connections. Each server connection has to have a body of code behind it to process incoming connections. Although EWB 100 technically includes a “web server”, it is really a very simple dispatching of requests to dedicated subroutines which will process the HTTP request payload and send a response.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Pattern can have following values. 1. 2. 3. 4. 5. 6. off once slow fast on twice Example to turn LED green and blink http://< device addr>/led?color=green&pattern=slow 17.2.3 System Reset System reset command will reset the system. It does not take any parameters: http://192.168.0.104/reset 17.2.4 CLI Command Execution Any CLI command can be sent to a device and executed and the command output is sent back to the requestor in the response.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 17.3 Configuration Commands 17.3.1 Disable HTTP Server If set, the device will disable CLI via the HTTP server. Other HTTP functions will still operate. The function is controlled by the following configuration bit in the “misc new3” command: The bit value is 0x8000. The server is enabled by default. 17.3.2 Port This comment specifies the TCP port number used by the http server.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18 Obtaining Device Status Information 18.1 Basic Concepts The EWB100 does not have a graphical interface and so the user cannot look at a screen in order to determine the state of the device.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.3.2 Information Available After one beep basic status information is played. This includes: • • • • Association status Signal strength in dbm Battery strength Current profile After two beeps important configuration is played. This includes: • • • • • • • • • IP address IP mask IP default gateway Lower 16 bits of current BSS (in hex) MAC address of device (in hex) Current radio channel Current ESS (spelled character by character) Current 802.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.4 Status Message 18.4.1 Device Status Update Mechanism The Device status update process involves the device transmitting via UDP a collection of configuration and status/history information to a particular IP address. The contents of the packet are ASCII strings contains the name and value of each item.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.4.2 Enabling sending the Device Status Packet The device status packet is always sent once after a reset. This again is a legacy of the DA program. Whether it is sent again after that depends on the configuration command: set airb deployrecord xx where xx can be “manual” or “auto”. “auto” enables the sending of the device status packet on a regular basis.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.5 Roam Command The roam command displaces the last 16 roams by the 802.11 radio. It is a circular buffer that displays the time, access point, and reason for each roam. It takes no parameters. The output format is: --time: 60.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.1 Wireless Driver Counters This command lists counters associated with the WLAN driver. Many of these counters are meaningful only to developers who are familiar with internals of the WLAN driver. The few that may be of more general interest are noted below (‘*’). There are two forms with and without a parameter (any value will do). More counters are shown with the parameter First Form >st wd --time: 105.
Motorola EWB100 Usage and Deployment Guide bad gp2 no rx bf tx err ic tx err tx dropped pkt out err trap ovr no kn buf no vo buf not nt q1 not nt qn : : : : : : : : : : : Rev 1.7 0 0 0 0 0 0 0 0 0 2 0 18.6.2 UMAC Counters This command lists some of the UMAC statistics. There are two forms, with and without a qualifier. The options are shown below: 18.6.2.1 No Parameter These counters record the total unicast, multicast, and retry packets. >st umac --time: 121.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.3 Transmit packet counters These counters record the number of each different type of packet transmitted. Voice packets are included in these counts. It also indicates the current transmit rate (in 0.5Mbit increments) and missed beacon %. >st umac tx --time: 128.120 tx rate miss bcn % tx failure tx null tx null fl tx poll tx assoc tx auth tx mc tx uc tx retry : : : : : : : : : : : 22 0 0 14 0 0 1 1 0 30 0 18.6.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.6 Receive Rate Histogram These counters show how many packets have been received at each rate. Only nonvoice packets are included. >st umac rrx --time: 155.728 1: 2: 5.5: 11: 6: 9: 12: 18: 24: 30: 48: 54: 00 00 00 00 00 00 00 00 00 00 00 00 18.6.7 Transmit Rate Histogram These counters show how many packets have been transmited at each rate. All packet types are included. >st umac rtx --time: 155.728 1: 2: 5.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.8 Transmit Retry Histogram These counters show how the distribution of packet transmit retries >st umac rtx --time: 155.728 0: 1: 2: 3: 4: … 15: 00 00 00 00 00 00 18.6.9 AP Tables This command displays information about the points. There are two forms of the command, parameter. The first form gives information associated AP, the second gives information current and known access with and without a about the currently about all known APs.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.10 Receive Packet Statistics This command displays information received packets. It shows informationon the last 16 received packets. Information includes: • Time in microseconds since last packet • Received data rate • RSSI • Packet size The table wraps around on itself. >st rx --time: 152.707 00014657: 00022457: 00030258: 00038057: 00041957: 00043907: 00047807: …. 0 0 0 0 0 0 0 37 36 36 39 37 37 39 110 110 110 110 110 110 110 18.6.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.12 TCP Counters This command provides information about the number of TCP connections that have been attempted and established as well as the number and types of packets that have been transmitted and received. >st tcp --time: 179.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.14 ICMP Counters This command provides information about the number of ICMP packets that have been transmitted and received. >st icmp --time: 184.940 InMsg InErr InEcho InEchoR OutMsg OutEcho OutEchoR : : : : : : : 0 0 0 0 0 0 0 18.6.15 Arp Tables This command displays information on both the number and types of ARP packets that have been transmitted and received as well as the current “arp table” that provides IP address to MAC address mapping.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.16 802.1x Key Derivation Counters This command displays counters derived from the operation of the 802.1x key derivation handshake protocol. The number of type of each receved packet is displayed. There are are also counters for Michael and Mic errors. >st sup --time: 193.115 Wpa State 802.1x Rcvd Msg 1 Rcvd Msg 3 Rcvd GK Rcvd Msg Timeouts Fmt Errs Mich Errs Mic Errs : WSUP_STATE_WPA_IDLE : 0 : 0 : 0 : 0 : 0 : 0 : 0 : 0 18.6.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.18 “IF” Counters This command provides information about the number of TCP, UDP, ARP, DHCP, etc.. packets that have been transmitted and received. >st if --time: 200.856 InOct InUcP InMcP InDis InErr InUnk OutOct OutUcP OutMcP OutDis OutErr : 0 : 0 : 0 : 0 : 0 : 0 : 672 : 0 : 16 : 16 : 0 18.6.19 Deployment Counters This counters display how many UDP status packets have been sent as well as how many airbeam packets were transmitted/received.
Motorola EWB100 Usage and Deployment Guide 18.6.20.1 This form Rev 1.7 Simple form (no parameter) >st wtt --time: 208.639 pkts pkts lost lost lost tx rx 0 1 n 18.6.20.2 : : : : : 0 0 0 0 0 Form 1 >st wtt 1 --time: 211.
Motorola EWB100 Usage and Deployment Guide 18.6.20.3 Rev 1.7 Form 2 >st wtt 2 --time: 214.216 pkts pkts lost lost lost tx rx 0 1 n : : : : : 0 0 0 0 0 : : : : : 0 0 0 0 0 wtt gaps 0: 1: 2: 3: 4: 5: 6: 7: 8: 9: 0 0 0 0 0 0 0 0 0 0 18.6.20.4 Form 3 >st wtt 3 --time: 217.048 pkts pkts lost lost lost tx rx 0 1 n 18.6.21 Unicast Counters This command displays the counters that record unicast/Private Reply sessions and transmit/received packets.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 18.6.22 DNS Counters and table This command displays DNS packet counts, the known DNS servers , and the current name to IP address mappings. >st dns --time: 225.777 DNS client statistics: No DNS servers in list DNS cache entries: runtime errors: requests sent: replys received: useable replys: dnsc_retry: timeouts: : : : : : : 0 0 0 0 0 0 18.6.23 Configuration Counters This command displays information about the state of configuration data base.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 19 Trace This command sets the level of trace for the various subsystems on the EWB100 device. There are two forms of the trace state, one for umac tracing and the other for all other subsystem. Changes to trace options take effect immediately. 19.1.1 NonUmac Tracing For all tracing except umac, the format is: set trace x y Where x is the subsystem name and y is the level of detail.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 19.1.2 Umac Tracing Umac tracing is more complex because there are many tracing entities within the umac subsystem. The general format is: set tra umax xx yy Where xx is the tracing entity and yy is either 0 (no tracing) or 7f (full tracing). There are some other possible values for yy but they are untested. Values for the tracing entities are listing below. Not all may generate actual tracing output.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 20 MiniKernel Commands This section describes the minikernel commands. The minikernel cli is entered by entering D (Capital D) immediately after the system boots up. The minikernel will wait a short amount of time (~3-10 seconds, depending on whether the RS232 or USB serial interface is connected) for the D command to be entered before proceeding to start the runtime code. In addition to the D command, any of the following commands can also be entered.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 20.2 Version This command displays the version of the minikernel and some hardware information. The command is: version It takes no parameters. The output is: Motorola CA10 Version 1.1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide ASSOCTED TRAPSI ASSOC REASSOC LASTAP LSTARTS RSTART RDECLN RI LTO RXTXCNT RXTXWN RXTXLST PKTTX PKTRX LOST0 LOST1 LOSTN UROAMS USCANS UASSOC DEAUT MISBEA DSSlpBlkng DSAttempt DSReady DSSlept DSGsmAwake DSKeyAwake DSUmacActive DSDspIdleMode Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Appendix B: Utility Program This section describes how to use a number of “utility programs” that are useful with the EWB100 B.1 clientencrypttool There is a Windows program for calculating encrypted values for WPA and CLI configuration values. This program can be found in the EWB100 section of http://support.symbol.com. The program runs from a Windows Command Line. The syntax is: cliencryptool xxx where xx is the value to be encrypted.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Appendix C: Utilizing the USB Interface with Win/XP This appendix describes how to install the EWB100 USB Drivers and how to use Hyperterm to communicate with the EWB100 CLI when using Windows XP, 32 bit edition. The USB drivers can be found in the EWB100 section of http://support.symbol.com. Vista/Windows 7 setup is described in a later section. The EWB100 uses a special physical connector that plugs onto the side of the device.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The following window sequence will appear after the above window is closed. It will also appear if a running EWB100 is plugged into a PC for the first time.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 This assumes the drivers are located in an external drive/directory named: E:\EWB100\drivers The contents of this directory are: . Enter this directory in the search box as shown below and select Next.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 The following indicates success At this point the driver is installed and we can startup Hyperterm. The USB connection will appear as a serial port to Hyperterm. The exact port number will generally depend on which physical USB port on the PC the EWB100 is plugged into as well as the presence of other USB peripherals.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 available from the “Control Panel” as seen below: Alternately one can wait and just open the “properties” menu item on Hyperterm and see the list of possible ports. In any case one must pick the desired port to connect with via this window. One must also configure the Port settings.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 At this point “Connect” to the port and you should see approximately the following. Alternatively one may just see the CLI prompt “>”. How much one sees depends upon where the EWB100 is in its bootup sequence when the USB is attached to Hyperterm.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Appendix D: Utilizing the USB Interface with Vista and Win/7 This section will describe how to use the USB interface with Windows Vista and Windows 7 (64 bit versions). This process uses the sames USB drivers as used with Windows XP. We assume they are on the external drive/directory: E:\EWB100\drivers. The USB drivers can be found in the EWB100 section of http://support.symbol.com.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 Right click on “CA10” and select “Update Drivers”. The following window will appear: Select the 2nd option – “Browse my computer for driver software” Enter the location where you have copied the files for the USB CA10 drivers. Point to the expanded folder with the CA10 drivers (E:\EWB100\drivers) and select it. Ignore the unsigned driver warning.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 At this point the drivers will have been installed. Remove the EWB100 and reinsert it. The drivers should recognize the device now. As noted above, inserting the device into a different physical USB port on the PC may require reinstalling the drivers. The terminal emulator program, such as hyperterm, can be configured to use the newly installed drivers. If hyperterm is used, the configuration procedure described in Appendix C may be used.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 A final note in operation with Win7: After installing the drivers, but before plugging in device to use with hyperterm, have hyperterm running and ready to open the device as you plug in the EWB100/CA10. A pre-saved profile can be created to facilitate this: Use file->open to select your previously saved connection.
Motorola EWB100 Usage and Deployment Guide Rev 1.7 While the device is connected in this fashion with hyperterm executing in admin mode, you should not experience any resets due to Win7 of the device.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.
Motorola EWB100 Usage and Deployment Guide Rev 1.