Zebra MotionWorks Proximity Client 1.2 MotionWorks Proximity Client 1.2 User Guide (en)
MotionWorks
Proximity
Client
User Guide
MN-003978-02EN Rev. A
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in
many jurisdictions worldwide. Google, Android, Google Play and other marks are trademarks of Google
LLC. All other trademarks are the property of their respective owners.
© 2020 Zebra Technologies Corporation and/or its affiliates. All rights reserved.
Information in this document is subject to change without notice. The software described in this document
is furnished under a license agreement or nondisclosure agreement. The software may be used or copied
only in accordance with the terms of those agreements.
For further information regarding legal and proprietary statements, please go to:
SOFTWARE:zebra.com/linkoslegal
COPYRIGHTS:zebra.com/copyright
WARRANTY:zebra.com/warranty
END USER LICENSE AGREEMENT: zebra.com/eula
Terms of Use
Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries
(“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described herein. Such proprietary information may not be used, reproduced,
or disclosed to any other parties for any other purpose without the express, written permission of Zebra
Technologies.
Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are
subject to change without notice.
Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are
correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and
disclaims liability resulting therefrom.
Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the
accompanying product (including hardware and software) be liable for any damages whatsoever
(including, without limitation, consequential damages including loss of business profits, business
interruption, or loss of business information) arising out of the use of, the results of use of, or inability to
use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some
jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above
limitation or exclusion may not apply to you.
Publication Date
November 24, 2020
Version 1.1.0.131
2
Contents
About This Document ........................................................................................................................ 5
Introduction ...................................................................................................................... 5
Chapter Descriptions........................................................................................................ 5
Notational Conventions.................................................................................................... 5
Icon Conventions ............................................................................................................. 6
Related Documents and Software ................................................................................... 6
Service Information .......................................................................................................... 6
Introduction......................................................................................................................................... 7
Client Features................................................................................................................. 7
Supported Devices........................................................................................................... 8
Device Requirements....................................................................................................... 8
Network Requirements..................................................................................................... 8
Barcode Requirements .................................................................................................... 9
Device Cleaned ........................................................................................................ 9
User Associated Barcode ......................................................................................... 9
User Disassociated Barcode .................................................................................... 9
Installation......................................................................................................................................... 11
Download the MotionWorks Proximity Package ............................................................ 11
Importing the MotionWorks Proximity CSP File ............................................................. 11
Create StageNow Profiles.............................................................................................. 11
Installation Profile ................................................................................................... 11
Configuration Profile ............................................................................................... 12
Device Staging............................................................................................................... 12
Error Conditions...................................................................................................... 12
Notes ...................................................................................................................... 13
3
Contents
Configuration .................................................................................................................................... 14
Server Settings............................................................................................................... 14
Proximity Range Settings............................................................................................... 14
Proximity Alert Settings.................................................................................................. 14
Low Battery Alert Settings.............................................................................................. 15
Miscellaneous Settings .................................................................................................. 16
Application Mode Settings ...................................................................................... 16
Advanced Settings ......................................................................................................... 16
App Notification Settings................................................................................................ 16
App Notifications..................................................................................................... 17
Using the App ................................................................................................................................... 18
MotionWorks Proximity Flow.......................................................................................... 18
Unsanitized............................................................................................................. 18
Sanitized................................................................................................................. 19
User Associated ..................................................................................................... 20
Battery Low............................................................................................................. 24
Known Issues and Behaviors........................................................................................ 26
StageNow Profiles ............................................................................................................................ 27
Creating an Installation Profile ....................................................................................... 27
Prerequisite ............................................................................................................ 27
Procedure ............................................................................................................... 27
Creating the Configuration Profile.................................................................................. 30
Proximity Range Threshold Calibration ......................................................................................... 32
4
About This Document
Introduction
This guide provides information about using the MotionWorks Proximity (MWP) client application.
IMPORTANT: If you have a problem with your equipment, contact Zebra Global Customer Support for
your region. Contact information is available at: zebra.com/support
Chapter Descriptions
Topics covered in this guide are as follows:
• Introduction provides overview of the MotionWorks Proximity Client application.
• Installation provides information on installing the client on a Zebra mobile computer.
• Configuration provides information on the solution with Zebra mobile computers.
• Using the App provides information on using the client application.
.
• StageNow Profiles provides instructions for creating installation and configuration profiles.
• Proximity Range Threshold Calibration provides instructions for calibrating the proximity range
threshold values.
Notational Conventions
The following conventions are used in this document:
• Bold text is used to highlight the following:
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen
• Key names on a keypad
• Button names on a screen.
• Bullets (•) indicate:
• Action items
• Lists of alternatives
5
• Lists of required steps that are not necessarily sequential.
• Sequential lists (such as those that describe step-by-step procedures) appear as numbered lists.
Icon Conventions
The documentation set is designed to give the reader more visual clues. The following graphic icons are
used throughout the documentation set. These icons and their associated meanings are described below.
NOTE: The text here indicates information that is supplemental for the user to know and that is not
required to complete a task.
IMPORTANT: The text here indicates information that is important for the user to know.
CAUTION: If the precaution is not heeded, the user could receive minor or moderate injury.
WARNING: If danger is not avoided, the user CAN be seriously injured or killed.
About This Document
Related Documents and Software
The following documents provide more information about the MotionWorks Proximity Solution.
• MotionWorks Proximity Portal User Guide.
• MotionWorks Proximity Solution User Guide.
For the latest version of this guide and all guides, go to zebra.com/support
Service Information
If you have a problem with your equipment, contact Zebra Global Customer Support for your region.
Contact information is available at zebra.com/support
When contacting support, please have the following information available:
• Serial number of the unit
• Model number or product name
• Software/firmware type or version number
Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.
If your problem cannot be solved by Zebra Customer 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.
6
Introduction
With the recent onset of COVID-19 and its ability to spread quickly when individuals are in close contact,
there is an urgency for organizations to have the ability to quickly respond when an employee is positively
diagnosed with COVID-19 and to prevent further outbreaks in the workforce. MotionWorks Proximity
provides proximity alerts for employees to maintain a safe distance range and contact tracing so action can
be taken immediately in locating each individual which the infected employee may have interacted with,
isolating the spread of infection and ensuring the safety of other employees.
With MotionWorks Proximity, the device is inaccessible to the user until it has been sanitized and the user
agrees to proper device use. When a user is within safe proximity range of another user, a proximity alert
is triggered as a warning. Each proximity event is logged by the solution, including dwell time within that
distance and user names. If a user is positively diagnosed with COVID-19, a trace report can be generated
to pinpoint potential co-worker exposure so swift action can be taken to prevent further spread of the
infection.
Client Features
• Report device status and contact events periodically to the server.
• Trace contact exposure to limit workforce productivity impact once a worker experiences COVID-19
symptoms. Uses Bluetooth Low Energy (BLE) based proximity alert system and contact tracing
between worker devices.
• Device proximity alerts ensure workers maintain a safe distance from others.
• A centralized contact tracing system identifies exposed contacts at-risk, while protecting the infected
individual's identity.
• Simple tracing process using QR barcode scanning for:
• Device Disinfection - ensure devices are sanitized before use to prevent spread of infection
• User Association - associate the user to a device to track users and easily identify exposed contacts
at-risk.
• User Disassociation - disassociate the user from the device when returning the device to be
re-sanitized.
• Device low battery alerts to notify workers to take an action.
• Remote device management to install and configure the application using StageNow and Enterprise
Mobility Management (EMM) tools.
7
Supported Devices
Table 1 Current Supported Devices
Introduction
Device
EC30 Android ™ Oreo 01-23-18.00-OG-U15-STD
MC3300 Android Oreo 02-13-15.00-OG-U20-STD
MC3300 Android Nougat 01-01-49.00-NG-U20-STD
MC9300 Android Oreo 01-30-04.00-OG-U06-STD
TC21 Android 10 10-12-13.00-QG-U17-STD-HEL-04
TC26 Android 10 10-12-13.00-QG-U17-STD-HEL-04
TC51 Android Nougat 01-01-49.00-NG-U20-STD
TC51 Android Oreo 02-32-04-00-OG-U02-STD
TC52 Android Oreo 01-30-04.00-OG-U06-STD
TC56 Android Oreo 02-13-15.00-OG-U20-STD
TC57 Android Oreo 01-23-18.00-OG-U15-STD
TC70x Android Oreo 02-13-15.00-OG-U20-STD
TC70x Android Nougat 01-01-49.00-NG-U20-STD
TC72 Android Oreo 01-23-18.00-OG-U15-STD
TC77 Android Oreo 01-23-18.00-OG-U15-STD
TC8300 Android Oreo 01-30-04.00-OG-U13-STD
Operating
System
Supported BSP
Device Requirements
• Operating System:
• Android Oreo or Android Nougat with Google Mobile Services (GMS) (non-restricted).
• Google Play Services version 12.8.76 or higher.
• Bluetooth must be enabled for the device to detect other devices in proximity.
• Wi-Fi must be enabled and connected to the network to communicate with the server.
• For WWAN devices, GPS must be enabled.
• Location must be enabled on both WAN and WLAN devices to detect other devices in proximity.
• For WAN devices, in Location settings, select High Accuracy or Battery Saving modes.
• For Android 10 and higher, Battery Saver mode should always be off in order for the MVP app to detect
the beacons. If Battery Saver mode is set to Turn On, the MWP app will not be able to detect beacons.
Network Requirements
The client application sends the device status and contact events to the MotionWorks Proximity Solutions
server over HTTPS. The network port 443 must be enabled to reach the Google Cloud Firebase Platform.
The following URL must be accessible:
8
https://<<ProjectID>>.firebaseio.com
where <<ProjectID>> is supplied by Zebra services after the server is set-up.
Barcode Requirements
There are three types of required QR barcodes.
Device Cleaned
When the device is in the Unsanitized screen and after the device is disinfected, scan this barcode to
designate the device is cleaned or sanitized. JSON format required for the barcode:
zmwprox1://{id:"ffffffff-ffff-ffff-ffff-ffffffffffff",un:"Cleaned"}
After scanning the barcode, the device is then ready-for-use for an end user to scan their user barcode to
associate to the device.
Figure 1 Cleaned Barcode
Introduction
User Associated Barcode
When the device is in the Sanitized screen, scan this barcode to associate the user to the device for the
duration of their work shift and begin user login. JSON format required for the barcode (replace appropriate
strings where prompted):
zmwprox1://{id:"<<Enter valid user id to send to server>>”, un:"<<Enter user name to be
displayed on device screen>>"}
User Disassociated Barcode
When the device is associated to a specific user, the user can disassociate from the device by launching
the app then scanning the device return barcode. This disassociates the user from the device and the
device screen reverts back to the unsanitized screen. JSON format required for the barcode:
zmwprox1://{id:"00000000-0000-0000-0000-000000000000", un:"Returned"}
9
Figure 2 Return Device Barcode
Introduction
10
Installation
Install and configure the MotionWorks Proximity client app using StageNow or an EMM. After the
installation or upgrade, launch the application for it to start functioning.
Download the MotionWorks Proximity Package
Download the MotionWorks Proximity package from Zebra Support site, zebra.com/support.
Importing the MotionWorks Proximity CSP File
To import the MotionWorks Proximity CSP.zip file into the StageNow CSP Library:
1. In the StageNow home screen left menu, click CSP Library.
2. Upload the .zip file to the CSP Library by clicking Choose File then browsing to the .zip file, or by
dragging and dropping the .zip file. Click OK in the confirmation message.
3. Once successfully uploaded, the CSP Library is listed in the Plugin tab.
Figure 3 Import Plugin into CSP Library
Create StageNow Profiles
Create an Installation and Configuration profile.
Installation Profile
Create an Installation Profile to:
• Install the MotionWorks Proximity client .apk file.
11
Loading...