PTT EXPRESS

INSTALLATION AND
CONFIGURATION GUIDE
 PTT EXPRESS
INSTALLATION AND CONFIGURATION GUIDE
MN000074A03
Rev. B
February 2016
ii PTT Express Installation and Configuration Guide

No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means,
without permission in writing from Zebra. This includes electronic or mechanical means, such as photocopying,
recording, or information storage and retrieval systems. The material in this manual is subject to change
without notice.

The software is provided strictly on an “as is” basis. All software, including firmware, furnished to the user is on
a licensed basis. Zebra grants to the user a non-transferable and non-exclusive license to use each software
or firmware program delivered hereunder (licensed program). Except as noted below, such license may not be
assigned, sublicensed, or otherwise transferred by the user without prior written consent of Zebra. No right to
copy a licensed program in whole or in part is granted, except as permitted under copyright law. The user shall
not modify, merge, or incorporate any form or portion of a licensed program with other program material, create
a derivative work from a licensed program, or use a licensed program in a network without written permission
from Zebra. The user agrees to maintain Zebra’s copyright notice on the licensed programs delivered
hereunder, and to include the same on any authorized copies it makes, in whole or in part. The user agrees not
to decompile, disassemble, decode, or reverse engineer any licensed program delivered to the user or any
portion thereof.

Zebra reserves the right to make changes to any software or product to improve reliability, function, or design.

Zebra does not assume any product liability arising out of, or in connection with, the application or use of any
product, circuit, or application described herein.

No license is granted, either expressly or by implication, estoppel, or otherwise under any Zebraintellectual
property rights. An implied license only exists for equipment, circuits, and subsystems contained in Zebra
products.

Revision History
Changes to the original guide are listed below:

Change Date Description

-01 Rev A 10/2013 Initial release.

-02 Rev B 07/2015 Zebra rebranding.

-03 Rev B 02/2016 Remove references to Team Express and Android V1.1 configuration file settings.
iii
iv PTT Express Installation and Configuration Guide
TABLE OF CONTENTS

Revision History .............................................................................................................................. ii

About This Guide

Introduction ..................................................................................................................................... vii
Chapter Descriptions ...................................................................................................................... vii
Related Documents ........................................................................................................................ viii
Notational Conventions................................................................................................................... viii
Service Information ......................................................................................................................... ix

Chapter 1: Introduction
Introduction .................................................................................................................................... 1-1
PTT Express Solution Portfolio ...................................................................................................... 1-1
Devices Supported by PTT Express .............................................................................................. 1-1
PTT Communication Using the PTT Express Client ...................................................................... 1-2
Network .......................................................................................................................................... 1-2
Network Recommendations ........................................................................................................... 1-3
Recommended WLAN Access Point (AP) Configuration for PTT Express .............................. 1-3

Chapter 2: PTT Express Client Installation

Introduction .................................................................................................................................... 2-1
Installing the PTT Express Client ................................................................................................... 2-1
Uninstalling the PTT Express Client .............................................................................................. 2-2
Windows Devices ..................................................................................................................... 2-2
Android Devices ....................................................................................................................... 2-2
Updating PTT Express from a Prior Version .................................................................................. 2-3
Windows Devices ..................................................................................................................... 2-3
Android Devices ....................................................................................................................... 2-3
Installation/Operation Verification .................................................................................................. 2-4
Installation Using Mobile Device Managers ................................................................................... 2-4
vi PTT Express Installation and Configuration Guide

Chapter 3: Device Configurations

Introduction .................................................................................................................................... 3-1
Microsoft Windows Registry Settings ............................................................................................ 3-1
Call Timer Registry Settings .................................................................................................... 3-1
Private Response Registry Settings ........................................................................................ 3-2
Group Broadcast Multicast Registry Settings .......................................................................... 3-2
User Configurable Device Key for PTT Private Response and PTT Group Broadcast ........... 3-3
Private Key Configurations ...................................................................................................... 3-3
Do Not Disturb ......................................................................................................................... 3-4
Android Configuration File Settings ............................................................................................... 3-6
Radio Link Solution (RLS) Setup ................................................................................................... 3-6
Talk Group Configuration ............................................................................................................... 3-6

Chapter 4: Verification and Troubleshooting

Introduction .................................................................................................................................... 4-1
Verification ..................................................................................................................................... 4-1
Troubleshooting ............................................................................................................................. 4-2

Chapter 5: Tested Configurations

Introduction .................................................................................................................................... 5-1
Symbol WS5100 Test Environment 1 ............................................................................................ 5-2
Symbol WS5100 Test Environment 2 ............................................................................................ 5-3
Cisco WLAN Test Environment 1 .................................................................................................. 5-4
Cisco WLAN Test Environment 2 .................................................................................................. 5-5

Glossary

Index
ABOUT THIS GUIDE

Introduction
The PTT Express solution is part of Zebra‘s comprehensive portfolio of high performance, feature rich, converged
voice and data solutions that provide communication solutions to meet the needs of many different types of
enterprises and enterprise users.

The purpose of this document is to describe the installation and configuration procedures necessary in order to
prepare a site to take advantage of the PTT Express voice client.

NOTE This document contains Windows installation instructions for client versions 1.1.x. For Windows
installation instructions for client versions 1.2.x, refer to the appropriate section of the Release Notes for
your specific device.

Since wireless network infrastructure equipment varies from site to site, detailed network configuration is not
included. However, this document provides guidelines to aid in selecting parameters of the wireless infrastructure
that should ensure that the PTT Express client performs optimally.

This book provides an overview of the PTT Express solution and procedures for deployment.

Chapter Descriptions
Topics covered in this guide are as follows:

• Chapter 1, Introduction — This chapter provides an overview of the PTT Express solution, including the PTT
Express Portfolio, the supported enterprise devices, and specific requirements for the solution.
• Chapter 2, PTT Express Client Installation — This chapter provides instructions for installing the PTT
Express client on supported devices.
• Chapter 3, Device Configurations — This chapter describes the process for modifying required settings that
must be assigned particular values.
• Chapter 4, Verification and Troubleshooting — This chapter lists the steps in the validation process and
presents a troubleshooting FAQ.
• Chapter 5, Tested Configurations — This chapter shows typical test environments for validating the
enterprise devices with the Symbol WS5100 and Cisco WLAN.
viii PTT Express Installation and Configuration Guide

Related Documents
Refer to the following documents for associated information about the system.

Document Name Purpose

PTT Express User Provides an overview of Push-To-Talk (PTT) features of the PTT Express Solution.
Guide

Support information for View the website at: http://www.zebra.com/support.

your target devices

For the latest version of this guide and all guides, go to: http://www.zebra.com/support.

Notational Conventions
The following conventions are used in this document:

• Italics are used to highlight the following:

• Chapters and sections in this and related documents
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen.
• Bold text is used to highlight the following:
• Key names on a keypad
• Button names on a screen or window.
• bullets (•) indicate:
• Action items
• Lists of alternatives
• Lists of required steps that are not necessarily sequential
• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.

NOTE This symbol indicates something of special interest or importance to the reader. Failure to read the note
will not result in physical harm to the reader, equipment or data.

CAUTION This symbol indicates that if this information is ignored, the possibility of data or material damage may
occur.

WARNING! This symbol indicates that if this information is ignored the possibility that serious personal
injury may occur.
 About This Guide ix

Service Information
If you have a problem with your equipment, contact Zebra Support for your region. Contact information is
available at: http://www.zebra.com/support.

When contacting Global Customer Support, please have the following information available:

• Serial number of the unit

• Model number or product name
• Software type and version number.
Zebra responds to calls by E-mail or telephone within the time limits set forth in support agreements.

If your problem cannot be solved by Zebra Support, you may need to return your equipment for servicing and
will be given specific directions. Zebra is not responsible for any damages incurred during shipment if the
approved shipping container is not used. Shipping the units improperly can possibly void the warranty.

If you purchased your Zebra business product from a Zebra business partner, contact that business partner for
support.
x PTT Express Installation and Configuration Guide
CHAPTER 1 INTRODUCTION

Introduction
The PTT Express solution is one of Zebra’s converged voice and data solutions which provide communication
solutions for many different types of enterprises and enterprise users.

PTT Express Solution Portfolio

PTT Express solutions include:

• PTT VoWLAN is a single mode solution designed to provide service to mobile users inside the enterprise
without regard to their location inside the facility or throughout a campus environment. The solution
provides mobile access over the enterprise Wireless Local Area Network (WLAN) to comprehensive
voice and data services. This includes services such as telephony, Push-To-Talk (PTT), email, and text
messaging that are typically tethered to the desk.
• PTT Express client creates Push-To-Talk communication capability between different types of devices
including PTT Smartphones, and Mobile Computers. Leveraging existing WLAN infrastructure, this
solution delivers simple communications across devices without the need for a voice communication
server.
• EWB extends PTT Express across multiple channels.
• Radio Link Solutions (RLS) bridges analog radio channels to digital talk groups allowing radios to
communicate with PTT smartphones and mobile computers.

Devices Supported by PTT Express

Refer to the PTT Express User Guide for a list of supported devices.

The PTT Express client allows these devices to create Push-To-Talk communication capability between
different types of devices. Some of the devices listed may require a software download/install to add PTT
express to the device, but for many of the devices PTT Express comes pre-installed. The solution leverages
existing WLAN infrastructure and does not require a server. This solution is also compatible with 2-way radio
systems by deploying the PTT Radio Link Solution.
1-2 PTT Express Installation and Configuration Guide

PTT Communication Using the PTT Express Client

To establish PTT communication:

1. A user with a PTT Express enabled device presses the Group Broadcast button to initiate communication.

2. The initial message is broadcast to all users in the form of a Group Broadcast.

3. After the initial broadcast message, the users have two options:
• Any user can continue the Group Broadcast by pressing the Group Broadcast button.
• The intended recipient can turn the conversation into a Private Response with the originator of the
broadcast, using the Private Response key.

NOTE While a PTT communication key is pressed the user will not be able to use other device keys to perform
separate tasks. In general pressing multiple keys simultaneously will lead to inconsistent client behavior.

Network
Many characteristics of a wireless local-area network (WLAN) impact its ability to be used for deployment of a
Voice over Wireless LAN (VoWLAN) solution such as PTT Express. This section describes some of the
parameters of the wireless network that should be considered to ensure the network‘s ability to successfully
deliver voice traffic between devices running the PTT Express client.

PTT Express allows 63 users to communicate across a single sub-net. The Group Broadcast feature only
permits a single user to transmit to the other members of the Talkgroup at a given moment in time. Additionally,
it is assumed that at most half of the Talkgroup members (that is, approximately 32 users) are served by a
single access point. As members in the Talkgroup reply via the Private Call feature, they may communicate
privately to one another and Group Broadcasts may continue.

PTT Express Communication has been designed to minimize end-to-end audio delay. However, audio delay
may be up to two seconds or more depending on conditions of the network.

The PTT Express client Group Broadcast communication is made possible by transmitting audio packets to a
multicast address. Each device is configured to transmit to and receive from this address. The default value for
this address on Windows devices is provided in Table 1-1, along with the IP_PORT_BASE (Group Broadcast
port) that is required to be available on each device. These values may be modified from their default values as
described in Microsoft Windows Registry Settings on page 3-1, but each device in the group must be
configured with the same values for the parameters.

The PTT Express client Private Response communication utilizes SIP (Session Initiation Protocol) for call
signaling and sends audio packets via unicast transmissions between the devices in the Private Response.
The PvtLocalPort (SIP Private Response port) listed in Table 1-1 must be the same value on all devices.

Table 1-1 Configurable System Parameters

Parameter Description Default Range

IP_ADDRESS_BASE IP Multicast address used for Group 239.192.2.2 239.0.0.0 - 239.255.255.255

Broadcast communication

IP_PORT_BASE Port used for receiving Group 5000 1024 - 49151 <65535>
Broadcasts

PvtLocalPort Port used for receiving SIP signaling 4080 1024 - 49151 <65535>
 Introduction 1-3

Network Recommendations
If possible, preference should be given to running PTT Express in an 802.11a network because of common
interference sources in the frequency bands used by 802.11b/g. However, many 802.11b/g environments exist
and PTT Express can be installed on devices that operate in those frequency bands used by 802.11b/g. When
PTT Express is deployed in those 802.11b/g environments, preference should be given to using 802.11g to
avoid any 802.11b devices that would force the network to operate at slower speeds.

When using 802.11b/g, configure the network to operate on channels 1, 6, and 11 to minimize the frequencies
in use that interfere with one another. These channels are recommended when using 802.11b/g equipment.
Also, some devices which support 802.11b/g may be pre-configured to only scan for 802.11 beacons on these
channels.

NOTE The use of DFS Channels is not recommended.

The country code associated with network Access Points (APs) and the enterprise devices
must be in agreement. It is necessary that you assign the country code of the AP based on the
country of operation and that the same country code be assigned on the enterprise device.

It is not recommended to use 5.5 or 11 as the lowest basic rates with MPA2.0 devices.

Recommended WLAN Access Point (AP) Configuration for PTT Express

PTT Express communicates half-duplex voice traffic at a QoS of VOICE with sample rates of 200ms for Group
and 100ms for Private calls. It is recommended that the network support a DTIM of 2 based on a Beacon
Interval of 100ms. To ensure timely delivery against lower priority traffic a QoS of VOICE should be honored
across the network by supporting WMM.

Multicast rates on the AP configuration should be optimized. There is some variation between manufacturers
(Cisco, Zebra etc). Customers should use the following guidelines to set the multicast rates on their APs to
optimize performance.

Multicast Rate Selection

1. Choosing a Multicast Rate
PTT Express uses multicast distribution to implement Group Call. In contrast to unicast mode, each AP in
the ESS transmits the multicast packet once (no retries), at a fixed rate.
Choice of MC rate is similar to picking a Beacon rate, and should strike a balance between:
a. Lower rates propagate further. Multicast Tx rate should be low enough for a reception rate of at least
90% anywhere within a cell, by all of the target mobile devices.
b. However, an MC rate lower than necessary wastes airtime, and contributes to co-channel interference.

2. Setting the Multicast Rate

The MC rate policy varies with AP vendor, but usually cues on the Basic Rate settings. Two examples:
a. Zebra WLAN infrastructure: The MC rate is the lowest basic rate.
b. Cisco: MC rate is different for the Wireless Controllers and standalone APs:
• Access points running recent Cisco IOS versions are transmitting multicast and management
frames at the highest configured basic rate, and is a situation that could cause reliability problems.
• Access points running LWAPP or autonomous IOS should transmit multicast and management
frames at the lowest configured basic rate …. If reliable reception is a goal, then multicasts should
be transmitted at a low data rate.
1-4 PTT Express Installation and Configuration Guide

3. Summary
Determine how the MC rate is derived, typically from the Basic Rate settings, for the specific vendor,
model, and firmware Rev in play. Then, apply section 1.1 above.
a. Quick Start
Use just 1 basic rate. Start with 24Mb/s basic, and adjust downwards for good performance. As a
safety margin, drop the rate one more step.

Other Settings
1. IGMP Snooping
IGMP Snooping must be disabled.

2. Session Timer
The infrastructure session timer should be disabled or set to longer than the default value(24 hours is the
suggested value).
CHAPTER 2 PTT EXPRESS CLIENT
INSTALLATION

Introduction
It is recommended (but not required) that the enterprise device is associated on the network before installing
the PTT Express client on the device. Since at the end of the installation procedure, the device reboots and a
start up tone is played to indicate that the PTT Express application is functional.

Installing the PTT Express Client

NOTE Zebra does not support installations performed using 3rd party Device Manager solutions.

The default keys used for triggering PTT Express calls need to be remapped when installing PTT Express
on the devices listed in Chapter 3, Device Configurations.

For Windows devices, the use of ActiveSync is recommended for installation on the Mobile Computing
devices. This method is straightforward in that the files are copied to the target device and then run from the
target device.

In order to obtain application software or any available update files please go to the Zebra website
http://www.zebra.com/support. Once purchased, the requestor is assigned a username and password to
access and download the client.

Windows Devices Using ActiveSync

To install the client software on a Windows Mobile Computing device:

1. Establish ActiveSync connection by connecting your device to a computer with ActiveSync installed.

2. From the ActiveSync window click on the Explore icon.

3. Click on the My Windows Mobile-Based Device icon for full folder list.

4. Open the Temp folder and copy the installer_VC_FB_XXXX.cab file to the device.

5. From the device, use the File Explorer to select and run the installer_VC_FB_XXXX.cab file.
2-2 PTT Express Installation and Configuration Guide

6. After execution of the installer cab file, the device reboots. After reboot, if the device is connected to a Wi-Fi
network a tone is heard, indicating that the PTT Express services are available on the device.

Windows Devices Using an SD Card

To Install the PTT Express client using SD cards:

1. Remove the SD card from the device and connect to a host computer. For information on removing the SD
card refer to device’s user guide.

2. Copy the installer_VC_FB_XXXX.cab file to the SD card.

3. Reinsert the SD card into the device.

4. From the device, use the File Explorer to select and run the installer_VC_FB_XXXX.cab file.

5. After the execution of the installer cab file, the device reboots. After reboot, if the device is connected to a Wi-Fi
network a tone is heard, indicating that the PTT Express services are available on the device.

Android Devices
The PTT Express client comes pre-installed on all Android devices that support PTT.

Enterprise Wi-Fi Phone

The PTT Express client comes pre-installed on the Enterprise Wi-Fi Phone (EWP) smartphones. See the EWP
customer documentation for details.

Uninstalling the PTT Express Client

Windows Devices

NOTE You can only uninstall a client that was previously installed on the mobile computer. Clients that are part of
the factory image cannot be uninstalled.

1. Go to Start > Settings > System > Remove Program.

2. Select the PTT Express application and touch Remove. The Remove Program window appears. “Are you
sure you want to remove it?”

3. Select Yes.

NOTE For some versions of PTT Express the following message may appear. “The application is currently being
used... Re run after reboot.” Press OK to restart the device. After restart, follow steps 1 through 3 again to
uninstall the application.

4. After successful uninstallation the device will restart.

Android Devices
For Android devices, only updated versions of PTT Express can be uninstalled. Uninstalling an updated versions of
PTT Express replaces the updated version with the factory default version.

To uninstall updated PTT versions and revert to factory version:

 Installing the PTT Express Client on Enterprise Devices 2-3

1. Touch Settings.

2. Touch Apps.

3. Select PTT Express.

4. Touch Uninstall updates. The Uninstall updates? screen appears.

5. Touch OK.

6. Touch OK.

7. Reboot the device.

Updating PTT Express from a Prior Version

Windows Devices
To update PTT Express from a prior version on a Windows device:

1. Uninstall the old version of PTT Express. See Uninstalling the PTT Express Client.

2. After Uninstallation completes, install the new version of PTT Express. See Installing the PTT Express Client.

Android Devices
To update PTT Express from a prior version on an Android device:

1. Connect the device to a host computer using a micro USB cable.

2. The device will be displayed as mass storage device on the host computer.

3. Copy the PTTExpress-XXXX.APK file to the device.

4. Disconnect the micro USB cable from the device.

5. On the device, touch > . to open the File Browser.

6. Touch to view the microSD card root folder.

7. Select the PTTExpress-XXXX.APK file. The Replace app? window appears.

8. Touch OK.

9. Touch Install.

10. After Installation, touch Done.

NOTE After installation of a PTT Express update on an Android device it is recommended that the user performs a
reset (restart the device).
2-4 PTT Express Installation and Configuration Guide

Installation/Operation Verification
Ensure the device is connected to the network, with at least one other PTT Express enabled device and
perform the following tests to confirm successful operation:

1. Confirm that a Group Broadcast, or page communication can be initiated and that other devices receive
the spoken voice from the originating device.

2. Once a Group Broadcast communication has been successfully established, confirm that a
page-to-private, or Private Response, can be established.

3. While in a WAN call, ensure that page communication cannot be heard.

Installation Using Mobile Device Managers

The PTT Client installation file automatically reboots the device after installation. When installing the PTT
Express client application using a Mobile Device Management (MDM) tool, it might be desired not to reboot the
device after the PTT Express Client application installation. Especially when installing other applications after
the PTT Express Client.

To disable the reboot, the client must be set to a Silent Install mode. Silent Install disables the automatic reboot
after the PTT Express Client installation.

Using a text editor, create a text file with the following:

[installation]
reboot=false

Save the text file with the filename: pttexpress.ini.

Using the MDM push the file to the Application folder before installing the PTT Express Client application.

NOTE After all applications are installed using the MDM, the MDM must reboot the device.
CHAPTER 3 DEVICE CONFIGURATIONS

Introduction
THis chapter provides information for configuring PTT Express on Microsoft Windows devices and Android
devices.

Microsoft Windows Registry Settings

A registry editor is required to view and modify the registry settings on a device. Note that after modifying
registry settings, a warm boot or cold boot of the device is required in order to have the changes take effect.

NOTE Altering any registry items other than those described in this manual are not supported and could result in
the impaired operation of the device.

If installing PTT Express on the MC3190, the buttons for initiating PTT Express group calls and private
calls must be remapped.
There are two types of mobile computer devices for PTT; those with side grey buttons used for PTT Group
Calls and those without.

The devices with the side buttons are the MC55 and MC75; for these devices, after installation the side
gray button is used for PTT group and the green key for PTT private call. For the rest of the devices, after
installation, the user needs to define which keys to use, normally users use the =5‘ key (Group) and the =9‘
(Private) keys. They define the keys by modifying values in the registry; the values are hex codes obtained
from a key check application which displays the hex code upon pressing a key. The application is obtained
from the http://www.zebra.com/support web site as part of the EMDK sample applications.

Call Timer Registry Settings

Use a registry key to modify the parameters indicated in Table 3-1. The registry path is:
HKEY_LOCAL_MACHINE\Software\Motorola\CVC
3-2 PTT Express Installation and Configuration Guide

Table 3-1 Call Timer Registry Settings

Key Type Range/Default Description

PrivateTalkTimeOut DWORD 10000 - 90000 ms The amount of time that has to elapse after
default = 60000 ms which the Private Response terminates and
the unit switches to PTT mode. Decimal
Value in milliseconds. disable = 0

TalkTimeOut DWORD 10000 - 90000 ms The amount of time the user is allowed to
default = 60000 ms hold the floor (talk without interruption).
Decimal Value in milliseconds. disable = 0

END_SESSION DWORD 1000 - 10000 ms The amount of time that has to elapse after
default = 10000 ms which a Private Response cannot be made
to the last known talker in the session.
Decimal Value in milliseconds.

NOTE Note that the hang time represents a minimum value and may vary by up to 1 second due to possible
network and protocol delays. For example, if a value of 5 is entered, the hang time is actually between 5
and 6 seconds.

Private Response Registry Settings

Use a registry key to modify the parameters indicated in Table 3-2. The registry path is:
HKEY_LOCAL_MACHINE\Software\Motorola\CVC\DCMe

Table 3-2 Private Response Registry Settings

Key Type Default Description

PvtHangTimerDuration DWORD 1000 - 10000 ms The amount of time that has to elapse after
default = 10000 ms which the Private Response will terminate
and the device will switch to Group
Broadcast mode. Decimal Value in
milliseconds.

PvtLocalPort DWORD 4080 IP Port to be used for Private Response

communications. Decimal value.

Group Broadcast Multicast Registry Settings

Use a registry key to modify the indicated parameters in Table 3-3. The registry path is:
HKEY_LOCAL_MACHINE\Software\Motorola\CVC\WTM

Table 3-3 Group Broadcast Multicast Registry Settings

Key Type Default Description

IP_ADDRESS_BASE 239.192.2.2 Multicast address to be used for Group Broadcast

communications.

IP_PORT_BASE DWORD 5000 IP Port number of the multicast address being used
for Group Broadcast communications. Decimal value
 Device Configurations 3-3

User Configurable Device Key for PTT Private Response and PTT Group Broadcast
A registry editor is required to view and modify the user configurable device keys. Note that after modifying the
configurable device key, a soft-reset of the device is required in order to have the changes take effect.

The registry path is: HKEY_LOCAL_MACHINE\Software\Motorola\CVC\Keys\

NOTE The following key settings apply to Zebra Mobile Computing devices only. Only one button can be
assigned as the pttPrivateCall (Private Response) key and one button can be assigned as the
pttGroupCall (Group Broadcast) key.

Table 3-4 User Configurable Device key to be used for Private Response on a Mobile Computer

KEY Type Range/Default Description

pttPrivateCall DWORD 7E (hex) Hex/decimal value of physical key to be pressed for usage
126 (decimal) in Private Call. Green Key (most MCs)

20 (hex) Space Bar

32 (decimal)

D (hex) Enter/Return Key

13 (decimal)

pttGroupCall DWORD 7E (hex) Hex/decimal value of physical key to be pressed for usage
126 (decimal) in Group Call.

20 (hex) Space Bar

32 (decimal)

D (hex) Enter/Return Key

13 (decimal)

NOTE Registry key values need to be updated after installing PTT Express on the MC3190 as it lacks dedicated
keys for PTT Express group calls and private calls:
To determine key codes, the KeyCheck.exe application is run on the device, key to be used is pressed
and keycode in hex is displayed. For example, the =5‘ key will show 0x35 and the =9‘ will show =0x39‘ in
the WM_KEYUP and WM_KEYDOWN events, it is the 0x35, 0x39 values that will be set in the registry
key(s).

The KeyCheck.exe application is obtained from the support.symbol.com web site as part of the
EMDK/SMDK sample applications.

Private Key Configurations

A registry editor is required to view and modify the user configurable device keys. Note that after modifying the
configurable device key, a soft-reset of the device is required in order to have the changes take effect.

The registry path is: HKEY_LOCAL_MACHINE\Software\Motorola\CVC\Keys.

3-4 PTT Express Installation and Configuration Guide

Table 3-5 User Configurable Device key to be used for Private Response on a Mobile Computer

KEY Type Range/Default Description

PrivateKeyConfig DWORD 0 Disable private calls.

1 Private Call is made using 1.5 Key press of Group Call
button. 1.5 Key press implies Group Call button pattern:
Press + Release + Press back within durations specified
by PrivatecallOffset1 and PrivatecallOffset2.
NP or any other Dedicated keys for Group Call and Private Call.
value

PrivatecallOffset1 DWORD NP, NP 300ms and 500 ms respectively (default)

PrivatecallOffset2 0, 0 300ms and 500 ms respectively (default)
t1, t2 (T2-T1) ms, (T3-T2) ms
0, t2 The total window (T3 – T1) will be t2 ms.

NP = Not present.

Valid when Private Call is made using 1.5 key press of Group Call button. (i.e. when PrivateKeyConfig = 1).

Key press timings in milliseconds:

• T1 - 1st Group Call button press

• T2 - Group Call button release
• T3 - 2nd Group Call button press.
1. By default PrivatecallOffset1 and PrivatecallOffset2 shall not be present in the registry. In this case and
when PrivatecallOffset1 and PrivatecallOffset2 are set to zero, default values of 300ms and 500 ms are
assigned respectively.

2. If PrivatecallOffset1 = 0, then the total window (T3 - T1) will be PrivatecallOffset2 ms.

3. If PrivatecallOffset1 and PrivatecallOffset2 are non-zero, then T2 - T1 should be PrivatecallOffset1ms and

T3 - T2 should be PrivatecallOffset2 ms.

4. T3 - T1 should always be less than 1000 ms., if it's more, then we will set to default : T2-T1 = 300 ms and
T3-T2 = 500 ms.

5. On the VC70, by default, PrivateKeyConfig = 1 and PrivatecallOffset1 = NP and PrivateCallOffset2 = NP.

6. All other devices, by default, PrivateKeyConfig = NP and PrivatecallOffset1 = NP and PrivateCallOffset2 =

NP.

7. On the VC70, the microphone button is used for Group Call and the 1.5 key press of the microphone
button for Private Calls.

Do Not Disturb
A registry editor is required to view and modify the user configurable device keys. Note that after modifying the
configurable device key, a soft-reset of the device is required in order to have the changes take effect.

The registry path is: HKEY_LOCAL_MACHINE\Software\Motorola\CVC\.

 Device Configurations 3-5

Table 3-6 Do Not Disturb

KEY Type Range/Default Description

DNDSupport DWORD 0, NP Disabled (default)

1 Enabled

NP = Not present.
3-6 PTT Express Installation and Configuration Guide

Android Configuration File Settings

Configuration of the PTT Express voice client is controlled by a configuration XML file. The configuration file is
divided into:

• Application settings
• Profile List settings
• Channel settings
Refer to Client Configuration in the PTT Express V1.2 User Guide for information on the Android configuration
file settings.

Radio Link Solution (RLS) Setup

RLS solution is required to allow PTT Express enterprise devices to conduct Group Broadcasts with 2-Way
radios. For a complete understanding of RLS, see the quick reference guide included with the RLS unit.

Only Group Calls are supported using the RLS Solution. Private responses are not supported.

Talk Group Configuration

Up to 32 talk groups can be created by PTT Express users. However, only one talk group may be enabled at a
time. To toggle between desired talk groups:

1. From the enterprise device Start button, select Programs > PTT Express Configuration.
The PTT Express Configuration window opens showing the default values of:
• Voice Client Enable: selected
• Current Talk Group: 1
2. To determine the PTT Express version at any time, select the About button at the bottom of the screen.

3. To disable the PTT Express voice client PTT communication, select or deselect the Voice Client Enable
field. This toggles the service between active and inactive.

4. To select a different talk group, click the drop down menu of the Current Talk Group field.
Talk groups 1 through 32 are displayed.

5. Select the desired talk group.

The newly selected talk group is the one that is enabled.

6. Press Save to activate changes.

An audible service tone indicates the Voice Client status.
CHAPTER 4 VERIFICATION AND
TROUBLESHOOTING

Introduction
It is important to verify the operation of the PTT Express after installing the PTT Express client on the
enterprise devices. Verify that on a Group Broadcast, the target devices are able to receive/playback audio
from the originator and that the user is able to respond to Group Broadcast requests. Then verify that a Private
Response request and response can be established.

The following sections list the verification procedures used to validate the successful installation and
configuration of the PTT Express client and a Frequently Asked Questions (FAQ) related to installation and
configuration.

Verification
The following list indicates the tests recommended to validate the installation and configuration of the PTT
Express Client.

• Download client software from a pre-defined web site.

• Install PTT Express Client software.
• Hold Multicast/ Group Broadcast Conversation. See the PTT Express Users Guide for instructions. The
guide can be downloaded from: http://www.zebra.com/support.
• Hold a Private Conversation. See the PTT Express Users Guide for instructions. The guide can be
downloaded from: http://www.zebra.com/support.
• Provision Mobility Services Platform Server with PTT Express client package (for subsequent download)
• Enable/ disable PTT Express client.
• Dual Mode (Cellular/Express) call interactions.
• Roaming
• Interoperate with Radio Link Server Donor device.
• Set Group/Private Response Key.
• Configure handset device parameters.
4-2 PTT Express Installation and Configuration Guide

• Configure WLAN parameters.

• Configure Multicast Traffic Processing router/device parameters.
• PTT Express interaction with Line of Business application.

Troubleshooting
Table 4-1 provides solutions to frequently encountered problems.

Table 4-1 Frequently Asked Questions

Question Answer

What should the WLAN WLAN Adapter should be set to Fast PowerSafe.
Adapter be set to?

What if you hear a “bonk” Check following items on the device

tone when pressing Group
Broadcast key?
• Check that the Wi-Fi is enabled.
• MCxx devices: check the Wi-Fi icon on bottom right hand corner of
the screen. If there is a red “X” it means that Wi-Fi is disabled.
• If disabled click the Wi-Fi icon and click on enable option.
• Check that the device is associated to Wi-Fi network and has acquired
an IP address.
• For MCxx devices, click on Wi-Fi icon on bottom right hand corner of
the screen.
• Click Wireless status.
• Click Current Profile [This will show ESSID: Channel Number: &
Signal Strength].
• Click on back arrow on top right hand corner.
• Click on IPv4 Status (This shows the Device IP address: Dynamic
Host Configuration Protocol IP address: DNS IP address etc.).

What if you hear Check signal strength, packet loss, speaker/microphone position.
non-intelligible audio?

What if there are association Check country code settings on both the device and the access point.
issues?

What happens if I perform a The PTT Express client is stored in persistent storage on supported Mobile
clean boot? Computers. The client remain loaded and in operation after a device warm or
cold boot. A user must re-install the client after a clean boot

What happens if I press While a PTT communication key is pressed the user will not be able to use other
multiple keys device keys to perform separate tasks. In general pressing multiple keys
simultaneously? simultaneously will lead to inconsistent client behavior.
CHAPTER 5 TESTED CONFIGURATIONS

Introduction
This following section contains the environments for which the operation of PTT Express Group Broadcast and
Private Response has been tested and validated:

NOTE Updated firmware versions may be available.

5-2 PTT Express Installation and Configuration Guide

Symbol WS5100 Test Environment 1

Table 5-1 Symbol WS5100 Test Environment 1

WLAN Configuration Parameter Value

Radio Access Network Switch RFS 6000 Series

Software Version 5.4.0.0-047R

Local Dynamic Host Configuration Protocol Enable

Multicast Configuration IGMP Snooping Disabled

Access Point1 AP650

Access Point2 AP650

Access Point Image 5.4.0.0-047R

WiFi Band 802.11 a/b/g

Access Point1 a Channel 149

Access Point2 a Channel 153

Access Point1 b/g Channel 1

Access Point2 b/g Channel 11

Encryption/ Security Setting WPA2/PSK/AES

Country Code US
 Tested Configurations 5-3

Symbol WS5100 Test Environment 2

Table 5-2 Symbol WS5100 Test Environment 2

WLAN Configuration Parameter Value

Radio Access Network Switch RFS 4000 Series

Software Version 5.4.0.0-047R

Local Dynamic Host Configuration Protocol Enable

Multicast Configuration IGMP Snooping Disabled

Access Point1 AP650

Access Point2 AP650

Access Point Image 5.4.0.0-047R

WiFi Band 802.11 a/b/g

Access Point1 a Channel 149

Access Point2 a Channel 153

Access Point1 b/g Channel 1

Access Point2 b/g Channel 11

Encryption/ Security Setting WPA2/PSK/AES

Country Code US
5-4 PTT Express Installation and Configuration Guide

Cisco WLAN Test Environment 1

Table 5-3 Cisco WLAN Test Environment 1

WLAN Configuration Parameter Value

Radio Access Network Switch Cisco Wireless LAN Controller 5500 Series

Software Version 7.0.220.0

Local Dynamic Host Configuration Protocol Enable

Multicast Configuration IGMP Snooping Disabled

Access Point1 AIR-CAP3502E-A-K9

Access Point2 AIR-CAP3502E-A-K9

Access Point Image C3500-K9W IOS 12.4(23c)JA3

WiFi Band 802.11 a/b/g

Access Point1 a Channel 149

Access Point2 a Channel 153

Access Point1 b/g Channel 1

Access Point2 b/g Channel 11

Encryption/ Security Setting WPA2/PSK/AES

Country Code US
 Tested Configurations 5-5

Cisco WLAN Test Environment 2

Table 5-4 Cisco 2500 Series Wireless LAN Controller

WLAN Configuration Parameter Value

Radio Access Network Switch Cisco 2500 Series Wireless LAN Controller

Software Version 7.0.220.0

Local Dynamic Host Configuration Protocol Enable

Multicast Configuration IGMP Snooping Disabled

IGN Snooping Disabled

Access Point1 AIR-CAP3502E-A-K9

Access Point2 AIR-CAP3502E-A-K9

Access Point Image C3500-K9W IOS 12.4(23c)JA3

WiFi Band 802.11 a/b/g

Access Point1 a Channel 149

Access Point2 a Channel 153

Access Point1 b/g Channel 1

Access Point2 b/g Channel 11

Encryption/ Security Setting WPA2/PSK/AES

Country Code US
5-6 PTT Express Installation and Configuration Guide
GLOSSARY

A
AP. Access Point or Access Port

ASCII. American Standard Code for Information Interchange

B
Backward Compatibility. Ability of new units to operate within an "old" system infrastructure, or to directly
communicate with an "old" unit.

Bandwidth. The difference between the limiting frequencies of a continuous frequency band, typically measured in
kilohertz. May be considered, the amount in kilohertz required for a single communications channel.

Broadcast. One to Many half duplex PTT communication

C
Call. An event beginning when a user requests voice resources (primarily RF channels), and ending when those
resources are released and available for a new request. A call consists of a series of console and radio
transmissions. A call is complete when all of the transmissions have ended and the hang time has expired.

D
dB. Decibels. Unit relating to power levels (for example, of a speech signal). DHCP — Dynamic Host Configuration
Protocol
Glossary - 2 PTT Express Installation and Configuration Guide

Delay. The delay experienced when a call arriving at an automatic switching device finds no idle channel or facility
available to process the call immediately.

DTIM. Delivery Traffic Indication Message

E
EWP. Enterprise Wi-Fi Phone

F
FMC Voice Client. Voice client that delivers multi-group push-to-talk communication, PBX integrated telephony
services, and WLAN text messaging. along with Cellular (WAN) voice and data service

G
G.729a. Codec used to Encode/Decode CVC PTT packets Group

Group Broadcast Button. Button for initiating Group Broadcast (1:N).

Group Broadcast Period. The maximum recording duration of a Group Broadcast PTT communication

Group Broadcast Timer. Timer that controls when and how long the user talk in single Group Broadcast

GUI . Graphical User Interface

I
ID. Identifier

IEEE. Institute of Electrical and Electronic Engineers

IM. Instant Messaging

IP. Internet Protocol

ITU-T. International Telecommunications Union-Telephony

L
LMT. Local Maintenance Terminal
 Glossary - 3

LOB. Line of Business

M
MC. Mobile Computer

MS. Mobile Subscriber

Mobility Services Platform (MSP). Device management client server solution for provisioning applications and
devices.

P
Page to Private Communication. Group Broadcast and Private Response PTT Communication

Private Response. One to One half duplex PTT Communication

Private Response Period. The maximum recording duration of a Private Response PTT communication.

Private Response Timer. that controls when and how long the user talk in single Private Response

PSTN. Public Switched Telephone Network

PTT. Push-To-Talk. Half duplex voice communication

PTT Express Voice Client. Voice client that enables Multiple Talk Group and Private Response PTT Communication

Q
QoS. Quality of Service

R
RAN. Radio Access Network

Reassured. Link Solution. Gateway that enables communication with 2-Way radios

S
SD. Storage Device
Glossary - 4 PTT Express Installation and Configuration Guide

SIP. Session Initiation Protocol

SSID. Service Set Identifier

U
URL. Uniform Resource Locator

V
VoIP. Voice over Internet Protocol

VoWLAN. Voice over Wireless Local Area Network

VoWLAN Voice Client. Voice client that delivers multi-group push-to-talk communication, PBX integrated telephony
services, and WLAN text messaging

W
WMM. Wi-Fi Multimedia

WLAN. Wireless Local Area Network

INDEX

C S
configurable system parameters . . . . . . . . . . . . . . . . 1-2 service information . . . . . . . . . . . . . . . . . . . . . . . . . . . . -ix
solution portfolio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
D
T
device configuration . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
devices supported by PTT Express . . . . . . . . . . . . . 1-1 talk group configuration . . . . . . . . . . . . . . . . . . . . . . . 3-6
test environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
F
FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
U
user configurable device keys . . . . . . . . . . . . . . . . . . 3-3
I
installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
V
installation using SD card . . . . . . . . . . . . . . . . . . . . . 2-2
installation verification . . . . . . . . . . . . . . . . . . . . . . . . 2-4 verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
installing client on mobile computers . . . . . . . . . . . . 2-1

N
network recommendations . . . . . . . . . . . . . . . . . . . . 1-3
network, WLAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

P
PTT communication . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

R
registry settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
related documents . . . . . . . . . . . . . . . . . . . . . . . . . . . -vii
RLS setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Index - 2 PTT Express Installation and Configuration Guide
Zebra Technologies Corporation
Lincolnshire, IL, U.S.A.

Zebra and the stylized Zebra head are trademarks of ZIH Corp., registered in many jurisdictions worldwide. All
other trademarks are the property of their respective owners.

© 2016 Symbol Technologies LLC, a subsidiary of Zebra Technologies Corporation. All rights reserved.

MN000074A03 Revision B - February 2016