SmartPTT Mobile Android Guide
SmartPTT Mobile Android Guide
September 2020
Revision History
Revision Description Date
2.0 Fourth release of the document. The document is compliant with SmartPTT September 2020
Mobile 5.1.0.
1.2 Third release of the document. The document is compliant with SmartPTT June 2020
Mobile 5.1.0.
1.1 Second release of the document. The document is compliant with SmartPTT April 2020
Mobile 5.0.1.
1.0 First release of the document. The document is compliant with SmartPTT March 2020
Mobile 5.0.0 beta.
2
Contents
Contents
Revision History ................................................................................................................................................ 2
1. Overview ....................................................................................................................................................... 6
3
Contents
4
About This Document
The document explains how to install, configure and use SmartPTT Mobile.
• Bold represents the names and titles of graphical user interface elements. For example, the Message field.
5
Overview
1 Overview
SmartPTT Mobile is an application that provides the ability to integrate mobile devices and MOTOTRBO radios into a
single communication network via SmartPTT Radioserver. SmartPTT Mobile users can receive and initiate individual
and group voice calls from/to radios and talkgroups, as well as other SmartPTT Mobile users.
SmartPTT Mobile is also integrated with SmartPTT Dispatcher. Administration of virtual groups created in SmartPTT
Mobile is also available to dispatchers. For information on integration with SmartPTT Dispatcher, see “SmartPTT
Mobile” in SmartPTT Installation and Configuration Guide.
1.1 Features
SmartPTT Mobile provides the following features:
• Voice communication with radios and DMR talkgroups (group calls and private calls).
• Voice communication with other SmartPTT Mobile users (group calls and private calls).
• Ability to create virtual groups for simultaneous voice communication with SmartPTT Mobile users and DMR
talkgroups.
NOTE
These groups can be managed both by SmartPTT Mobile users and by dispatchers. Virtual groups consisting only
of SmartPTT Mobile users are represented in SmartPTT Dispatcher as dynamic groups, and virtual groups, which
include DMR talkgroups, are presented as cross-patches between DMR talkgroups and dynamic groups (in
SmartPTT Dispatcher) or a multigroup (in the SmartPTT Mobile application).
• Ability to work in two modes: in high priority mode and in normal mode.
• Ability to see on a map the location of SmartPTT Mobile users and DMR radios.
6
Overview Requirements
1.2 Requirements
For the best SmartPTT Mobile operation, the following requirements must be met:
Parameter Value
Display size: 5”
Networking Requirements
Parameter Value
Jitter < 90 ms
NOTE
These are minimal system requirements for SmartPTT Mobile. They can change depending on a device.
7
Installation and Configuration
Before using SmartPTT Mobile you must configure client connections to support SmartPTT Mobile. For information
on SmartPTT Radioserver configuration, see "Configuring SmartPTT Mobile Connection" in SmartPTT Installation and
Configuration Guide.
Besides, you must create a client account in SmartPTT Radioserver Configurator for logging on to the application. For
details, see “Managing Client Accounts” in SmartPTT Installation and Configuration Guide.
SmartPTT Mobile can also interact with profiles, that are created in SmartPTT Radioserver Configurator and used to
limit client access to radio networks and actions within available radio networks. Before using SmartPTT Mobile you
must find out the necessity of assigning a profile to the client account. For details, see "Managing Profiles" in
SmartPTT Installation and Configuration Guide.
8
Reconnection to Radioserver
3 Reconnection to Radioserver
Below is described the SmartPTT Mobile operation during a loss of connection with SmartPTT Radioserver and
reconnection to it.
When reconnecting SmartPTT Mobile to SmartPTT Radioserver, the following scenarios of the mobile application
behavior are possible:
• If the reason for the loss of connection with SmartPTT Radioserver is the Internet disconnection, the mobile
application start screen will be displayed and the mobile application will wait for the restoration of the Internet
connection. As soon as the connection is restored, an attempt to establish a connection withSmartPTT
Radioserver is automatically initiated.
NOTE
An attempt to automatically reconnect with SmartPTT Radioserver is initiated every 30 seconds. If the SmartPTT
Mobile application operates normally, 3 attempts to automatically connect to SmartPTT Radioserver will be
initiated. If the SmartPTT Mobile application is running in high priority mode, the number of such attempts is not
limited until the connection is successfully established or until the SmartPTT Mobile user manually terminates the
attempts.
Important
Automatic connection to SmartPTT Radioserver will be established if successful client authorization was on
SmartPTT Radioserver before.
• If the connection with SmartPTT Radioserver> is lost because SmartPTT Radioserver for some reason closes the
connection, the mobile application start screen will be displayed, connection to SmartPTT Radioserver will not
be restored automatically.
• If for some reason the mobile application operation is stopped by the Android operating system, and the
application is unloaded from the device’s memory, then the next time you start it manually, the mobile
application start screen will be displayed, an attempt to restore connection with SmartPTT Radioserver will be
automatically initiated.
• If the device was rebooted, the mobile application start screen will be displayed, an attempt to restore
connection with SmartPTT Radioserver will be automatically initiated.
• After the client is log out, or SmartPTT Radioserver closed forcibly the connection, connection to SmartPTT
Radioserver will not be restored automatically.
• If the mobile application was closed by the SmartPTT Mobile user at the moment when connection with
SmartPTT Radioserver was lost, then an attempt to restore connection with SmartPTT Radioserver will be
automatically initiated at the next launch.
9
Using SmartPTT Mobile
Prerequisites:
Procedure:
6. In the Port field, type the SmartPTT Radioserver HTTPS port number.
10
Using SmartPTT Mobile Logging On to SmartPTT Mobile
7. Tap Login .
Postrequisites:
Menu ( )
Opens the SmartPTT Mobile side menu.
Find contacts ( )
Provides the ability to filter the Contact List by typing the beginning of a contact name in the search field that
appears in the middle of the Toolbar.
11
Using SmartPTT Mobile Navigating Contact List
The filter pane below the Toolbar provides the following filters for the Contact List:
• Private — the Contact List displays only radios and SmartPTT Mobile users.
• Group — the Contact List displays only DMR talkgroups and virtual groups.
The Contact List is the scrollable middle part of the window. Tapping a contact assigns it to the PTT button at the
bottom of the window. Clicking the button will initiate a call to the selected contact.
The icon to the left of the contact name indicates the type of the contact:
• DMR talkgroup ( )
• DMR radio ( )
• Virtual group ( )
• Multigroups ( )
For radios and SmartPTT Mobile users, online/offline status is displayed in the bottom right corner of the icon as a
green or gray circle respectively.
The PTT button at the bottom of the window provides voice call indication and the ability to initiate calls.
12
Using SmartPTT Mobile Voice Calls
• No voice call in progress, a contact is selected. You can tap PTT to initiate a call.
• Incoming voice call in progress. Voice call initiator name is displayed on the button.
• Channel hold mode (hangtime) in progress. None of the parties are transmitting the voice call.
In order to initiate a call, tap the desired contact in the Contact List, and then, depending on SmartPTT Mobile
settings, either tap and hold, or tap the button. As soon as the outgoing call indication appears (the PTT button
becomes orange), you can speak.
13
Using SmartPTT Mobile Voice Calls
4.3.3 Profile
A profile displays short information about the SmartPTT Mobile user, radio, virtual group or multigroup.
A profile opens when you click Profile in the actions menu of the desired contact.
The SmartPTT Mobile user or the radio profile provides the following information:
• Call history;
• Information about the location with the indication of coordinates and time, how long ago the last coordinates
were displayed;
• When you tap the location information, SmartPTT Mobile will open the map and display the object icon on it.
The profile of a virtual group consisting only of SmartPTT Mobile users provides the following information:
14
Using SmartPTT Mobile Voice Calls
• The total number of SmartPTT Mobile users in the group and the number of active users;
• Call history;
• Information about the location indicating the name of the user who sent the coordinates last, his coordinates,
as well as how long ago the last coordinates were displayed;
15
Using SmartPTT Mobile Voice Calls
• The total number of groups in the multigroup and the number of active groups;
NOTE
Call history is displayed separately for each contact in the contact list.
• type of event (indicated by the icon and signature under the contact's name). The following types are available:
• ( )— incoming call;
• ( )— outgoing call;
16
Using SmartPTT Mobile Voice Calls
NOTE
Multiple calls provides the ability to reduce the number of log entries. Under multiple call is meant a certain type of
combined calls, the time interval between which does not exceed 10 minutes. The total duration of multiple call is
not limited. Multiple call combines private calls initiated or received by the same SmartPTT Mobile user or radio
and group calls initiated by any contact in the same group.
• call duration.
NOTE
Call duration is considered as the time interval between the first click on the PTT button and the end of the last
hangtime or call interrupt.
17
Using SmartPTT Mobile Voice Calls
Back ( )
Returns to the contact list window.
Filter ( )
Opens the filtering window and provides the ability to filter calls by their type (incoming or outgoing). For virtual
groups, you can also filter calls by individual group participants.
Date ( )
Opens the calendar and provides the ability to select the desired date to see the call history for the desired day.
Clear ( )
Cancels the call history filtering. The button appears only if a filter is installed.
Prerequisites:
Procedure:
1. Open the call history window with one of the following ways:
To open the call history window from the perform the following actions:
SmartPTT Mobile user or radio actions
1. Tap More ( ) next to the
menu,
desired SmartPTT Mobile user or
radio in the contact list.
To open the call history window from the tap the call history icon ( ) in the
18
Using SmartPTT Mobile Voice Calls
To filter a list by the virtual group participant, perform the following actions:
4. To display call history for a specific date, perform the following actions:
NOTE
If you want to see the call history for other years, tap the year in the title bar. The calendar opens the call history
for January 1 of the selected year.
4.4 Location
SmartPTT Mobile supports Google Maps and Baidu Maps, that provides the ability to know the SmartPTT Mobile
user location, as well as to find location of radios added to your contact list. SmartPTT Mobile also provides the ability
to combine closely located contacts in a cluster.
• When you select Location from the SmartPTT Mobile side menu.
NOTE
SmartPTT Mobile sends the device coordinates to SmartPTT Radioserver every 15 seconds.
19
Using SmartPTT Mobile Location
4.4.1 Map
The map window appears after tapping Location .
Fig. 8. Map
Back ( )
Returns to the window with the contact list.
Find contacts ( )
Provides the ability to filter the Contact List by typing the beginning of a contact name in the search field that
appears in the middle of the Toolbar.
• Radios
20
Using SmartPTT Mobile Location
NOTE
The object also displays its status: online or offline. When you click on the object icon, a panel with information is
displayed below it, which contains the contact name, location coordinates (width and longitude) in degrees, the
address corresponding to the coordinates (if the address data provider is enabled in SmartPTT Dispatcher), the
PTT button.
NOTE
The cluster icon displays the number of nearby objects. Clicking on the cluster icon below displays a panel with
information about the number of contacts in the cluster and the number of inactive contacts.
Show me ( )
Centers the map on the icon of the SmartPTT Mobile user who opens the map, and is automatically blocked.
The button is activated if you swipe the map in any direction.
Prerequisites:
• Ensure you have the Google or Baidu API key to work with Google or Baidu Maps respectively.
• Ensure the address data provider is enabled in the positioning settings of SmartPTT Dispatcher.
• Ensure the desired SmartPTT Mobile user or radio is in the SmartPTT Mobile contact list.
Procedure:
To open a map from the SmartPTT Mobile menu, tap Location in the SmartPTT Mobile menu.
The map window appears.
To open the map from the actions menu of the perform the following actions:
SmartPTT Mobile user or radio,
1. Tap More ( ) next to the desired contact in the
contact list.
21
Using SmartPTT Mobile Location
To open a map from the profile of the SmartPTT 1. Tap More ( ) next to the desired contact in the
Mobile user or radio, contact list.
2. In the search field of the map window at the top of the toolbar, type the name of the contact whose location
you want to find:
a. Type the beginning of the desired contact name to filter the list.
Postrequisites:
To see the detailed information of the contact, tap its icon again.
A panel with information appears under the object icon.
4.5 Settings
The Settings menu contains SmartPTT Mobile settings, including location settings.
Prerequisites:
Procedure:
1. In the Contact List, swipe from the left edge of the screen or tap the Menu ( ) button in the top left corner of
the window.
SmartPTT Mobile side menu appears.
22
Using SmartPTT Mobile Settings
NOTE
By default the toggle is turned on.
To use Google Maps, from the list Online map provider, select Google.
To use Baidu Maps, from the list Online map provider, select Baidu .
To display coordinates only in degrees, from the list Coordinates Format, select Degrees
only.
23
Using SmartPTT Mobile Settings
To display coordinates in degrees, minutes and from the list Coordinates Format, select With
seconds, min&sec.
Prerequisites:
Procedure:
1. In the Contact List, swipe from the left edge of the screen or tap the Menu ( ) button in the top left corner of
the window.
SmartPTT Mobile side menu appears.
24
Using SmartPTT Mobile Settings
To configure SmartPTT Mobile to work in high turn on the High priority mode toggle.
priority mode,
To configure SmartPTT Mobile to work in normal turned off the High priority mode toggle.
mode,
Important
Regardless of the selected operation mode, SmartPTT Mobile is always interrupted by incoming phone calls.
NOTE
The priority of SmartPTT Mobile operation mode determines its behavior referring to SmartPTT Radioserver
connection, as well as interacting with the microphone and speaker when minimizing application (switching to
another application) or locking the screen when the application is active. In normal mode, connection with
SmartPTT Radioserver is interrupted, the microphone and speaker are not used by the application. In high priority
mode, connection with SmartPTT Radioserver is active, the application continues to use the speaker, but does not
use a microphone.
5. To have the device vibrate when a user initiates a call, turn on the Vibration Control toggle.
6. To suppress tones when a call begins, ends or is interrupted, turn on the Silent Mode toggle.
To initiate calls by tapping and holding PTT, turn off the Toggle PTT toggle.
8. In the Private Contact Selection Timeout line, tap the number to set the time in seconds during which a
private contact selected from a virtual group contact list will remain assigned to the PTT button. After that, the
PTT button will revert to the virtual group. Available values are 2, 4, 6, 8 and 10 seconds.
Virtual groups are a type of group call. When a virtual group is created, it appears in the contact lists of all SmartPTT
Mobile users added to the group. If required, any participant of the group can leave it.
Any participant of the group can edit or delete a virtual group if it is created by the SmartPTT Mobile user. If a
dispatcher edits a virtual group created by the SmartPTT Mobile user, then the SmartPTT Mobile user does not lose
the rights to edit the group he created. However, SmartPTT Mobile users cannot edit or delete groups created by the
dispatcher. All changes made in the SmartPTT Mobile application are displayed in SmartPTT Dispatcher and vice
versa.
25
Using SmartPTT Mobile Managing Virtual Groups
Prerequisites:
Procedure:
1. In the top right corner of the Contact List window, tap Select group type ( ) .
26
Using SmartPTT Mobile Managing Virtual Groups
c. To add a contact to the group, select the check box to the right of its name.
d. At the top of the window, tap Confirm ( ) to accept changes or Discard ( ) to discard them.
5. In the top right corner of the Group creation window, tap Confirm ( ) to create the group.
Prerequisites:
Procedure:
1. In the Contact List, to the right of the desired virtual group name, tap More ( )→ Profile.
Virtual group profile appears.
27
Using SmartPTT Mobile Managing Virtual Groups
28
Using SmartPTT Mobile Managing Virtual Groups
To remove a group participant, clear the check box to the right of their name.
5. In the top right corner of the Edit window, tap Confirm ( ) to save changes.
29
Using SmartPTT Mobile Managing Virtual Groups
Prerequisites:
Procedure:
1. In the Contact List, to the right of the desired virtual group name, tap More ( )→ Profile.
Virtual group profile appears.
NOTE
If the group is part of a multigroup, then it cannot be deleted.
30
Using SmartPTT Mobile Managing Virtual Groups
Prerequisites:
Procedure:
1. In the Contact List, to the right of the desired virtual group name, tap More ( )→ Profile.
Virtual group profile appears.
3. In the dialog box that appears, confirm that you want to leave the group.
31
Using SmartPTT Mobile Managing Multigroups
Important
In conventional systems, only one DMR talkgroup from each channel can be added to a multigroup.
NOTE
If the SmartPTT system configuration does not provide for a radio network, then the ability to create a multigroup
will be blocked.
Any participant of the multigroup can edit or delete a multigroup if it is created by the SmartPTT Mobile user. If a
dispatcher edits a multigroup created by the SmartPTT Mobile user, then the SmartPTT Mobile user does not lose
the rights to edit the group he created. However,SmartPTT Mobile users cannot edit or delete groups created by the
dispatcher. All changes made in the SmartPTT Mobile application are displayed in SmartPTT Dispatcher and vice
versa.
NOTE
If a virtual group created by the SmartPTT Mobile user has been included in a multigroup, it cannot be deleted
until it is removed from the multigroup.
Prerequisites:
• Ensure that you have created virtual teams consisting of SmartPTT Mobile users.
Procedure:
1. In the top right corner of the Contact List window, tap Select group type ( ) .
32
Using SmartPTT Mobile Managing Multigroups
33
Using SmartPTT Mobile Managing Multigroups
b. To add a group to the multigroup, select the check box to the right of its name.
c. At the top of the window, tap Confirm ( ) to accept changes or Discard ( ) to discard them.
5. In the top right corner of the Group creation window, tap Confirm ( ) to create the multigroup.
Prerequisites:
Procedure:
1. In the Contact List, to the right of the desired multigroup name, tap More ( )→ Profile.
Multigroup profile appears.
34
Using SmartPTT Mobile Managing Multigroups
35
Using SmartPTT Mobile Managing Multigroups
To remove a group from the multigroup, clear the check box to the right of their name.
5. In the top right corner of the Edit window, tap Confirm ( ) to save changes.
36
Using SmartPTT Mobile Managing Multigroups
Prerequisites:
Procedure:
1. In the Contact List, to the right of the desired multigroup name, tap More ( )→ Profile.
Multigroup profile appears.
37
Contact Information
The document describes the product developed by Elcomplus LLC. The official company’s website is
www.elcomplus.com.
For contact information with the Elcomplus LLC representatives, see www.smartptt.com/contacts/.
Technical Support
Customer support is provided by Technical Support Center. The official website of the Center is
support.smartptt.com.
In America, customer support is also provided by Elcomplus, Inc. To contact support engineers, use the following
contact information:
• Phone: +1 786-362-5525
• Email: [email protected]
Technical Support Center and Elcomplus, Inc. do not consult on deployment and maintenance of Motorola Solutions
products except on settings related to SmartPTT connection and data communication. For the technical support on
Motorola Solutions products, please contact an authorized Motorola Solutions representative in your region.
Customer Documentation
This document is authored and published by Elcomplus LLC. If you have any comments and suggestions on it, please
email them to [email protected].
Not part of this document must be reproduced, quoted, or translated to another language without explicit
permission from Elcomplus LLC.