Motorola Solutions D R AF T 2B -1 2 Ju ne 20 14 MPACT LOCATION & ANALYTICS DEPLOYMENT GUIDE
T AF R D 2B 2 -1 ne Ju 14 20
14 20 ne TABLE OF CONTENTS Ju Chapter 1 MPact Overview -1 2 1.1 MPact Architecture ........................................................................................................................................................1-2 1.1.1 MPact Beacons ...................................................................................................................................................1-2 1.1.2 MPact Server .............................................................................
Motorola Solutions MPact Location & Analytics Deployment Guide Chapter 4 Beacon Installation and Activation 14 4.1 Beacon Installation ........................................................................................................................................................4-2 4.2 Beacon Activation ..........................................................................................................................................................
20 14 • Using the Documentation D R AF T 2B -1 2 • Motorola Solutions, Inc.
Using the Documentation 14 The following sections provide information about the document and notational conventions used in the guides, and provides a list of related documentation. Intended Audience 20 This document is written for Motorola Solutions Partners and Product Managers. Document Conventions ! Ju NOTE: Indicates tips or special requirements.
About this Guide 7 Motorola Solutions, Inc. End-User License Agreement 14 BY INSTALLING AND/OR USING THIS PRODUCT, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT AND AGREE TO BE BOUND ITS TERMS. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, MOTOROLA SOLUTIONS IS NOT WILLING TO LICENSE THE PRODUCT TO YOU, AND YOU MUST NOT USE OR INSTALL THIS PRODUCT. ne 20 1. LICENSE GRANT.
OR ERROR FREE, OR THAT DEFECTS IN THE PRODUCTS WILL BE CORRECTED. MOTOROLA SOLUTIONS MAKES NO WARRANTY WITH RESPECT TO THE CORRECTNESS, ACCURACY, OR RELIABILITY OF THE PRODUCTS. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. 20 14 6. LIMITATION OF LIABILITY. THE TOTAL LIABILITY OF MOTOROLA SOLUTIONS UNDER THIS AGREEMENT FOR DAMAGES SHALL NOT EXCEED THE FAIR MARKET VALUE OF THE PRODUCTS LICENSED UNDER THIS AGREEMENT.
About this Guide 9 20 14 software, such obligations often include one or more of attribution obligations, distribution obligations, copyleft obligations, and intellectual property encumbrances. The use of any Open Source Software is subject to the terms and conditions of this Agreement as well as the terms and conditions of the corresponding license of each Open Source Software package.
T AF R D 2B 2 -1 ne Ju 14 20 10
14 20 ne CHAPTER 1 MPACT OVERVIEW Ju The Motorola Solutions MPact accurately locates Bluetooth® SMART 4.0 mobile client devices using distributed Bluetooth Low Energy (BLE) beacons and displays their location on a site’s floor plan. The beacon can be configured to be in one of three modes; Battery Saving, iBeacon or MPact. Battery Saving mode is optimized to save battery life. The iBeacon mode is configured to Apple’s iBeacon specification.
1-2 Motorola Solutions MPact Location & Analytics Deployment Guide 1.1 MPact Architecture The MPact architecture is comprised of the following: 14 • MPact Beacons • MPact Server • MPact Toolbox 2B -1 2 Ju ne 20 • MPact Client SDK T Figure 1-1 MPact Typical Topology AF 1.1.1 MPact Beacons D R MPact beacons are small, battery powered Bluetooth Low Energy (BLE) devices. Beacons are strategically placed in retail environments where customer locationing is wanted.
MPact Overview 1-3 1.1.2 MPact Server 14 The MPact Server, a location and analytics system can be installed on the Linux platform (Debian 7.3). It provides an interface to install and maintain MPact beacon positions throughout a deployment site. 20 The MPact Server receives its beacon data from customer’s devices moving about a retail environment.
1-4 Motorola Solutions MPact Location & Analytics Deployment Guide 1.
14 20 ne CHAPTER 2 MPACT SERVER INSTALLATION AND SETUP Ju For more information, refer to the following: • Server Installation and Login • Server Configuration 2 • Tree Setup • Category Configuration -1 • Floor Plan Setup D R AF T 2B • Beacon Place Holder Setup and Configuration
2-2 Motorola Solutions MPact Location & Analytics Deployment Guide 2.1 Server Installation and Login 14 The MPact Server is a Linux-based system. As a prerequisite to installing the MPact Server, ensure the server has the following capacity: • 4 Cores • 8GB RAM 20 • 200GB disk space • Operating System (OS): Debian 7.3 64-bit GUI If an older version of MPact is installed on the system, the older version must be uninstalled. To uninstall the MPact Server: ne 1. Open a terminal on the Debian 7.3 GUI.
2-3 -1 2 Ju ne 20 14 MPact Server Installation and Setup Figure 2-1 MPact Deployment - Expected Results 2.1.1 Server Login 2B When the server installation is complete, login to the server and configure the system parameters. To login to the MPact Server remotely: 1. Go to : 80/atls (use either Chrome or Firefox). 2. Enter the User Name (superuser is the default) and Password (motorola is the default), and select Login.
2-4 Motorola Solutions MPact Location & Analytics Deployment Guide 2.2 Server Configuration 14 Use System Configuration for the administration of beacon settings defined globally on the MPact Server. The beacon settings are then pushed to selected beacons as their respective configurations warrant. Beacon configuration settings must be set accurately in the MPact Server before they can be provisioned to an MPact Toolbox supported iPad. To administrate the system configuration: ne 20 1.
MPact Server Installation and Setup 2-5 Set the mode defining how beacons are emitted from MPact beacons. Supported modes include Battery Saving, iBeacon and MPact. The Battery Saving format, the default setting, is optimized for battery life by making the beacon as small as possible (the beacon contains the minimal amount of information needed to support MPact server functions).
2-6 Motorola Solutions MPact Location & Analytics Deployment Guide 5. Set the Network Proxy Settings to define how MPact server event subscribers receive their defined notifications over the MPact server. Set the Web domain location for the destination of uniquely defined subscriber event notifications (for example, www.hostname-example.com). Port Use the spinner control to set the virtual port integer for the connection between the MPact server and the defined proxy or IP address.
MPact Server Installation and Setup 2-7 2.3 Tree Setup 14 Use Tree Setup to build the tree hierarchy for each store site location on a global map. A tree hierarchy is built from a global site location down to each floor in a building, including floor plans for each floor in a building. After the tree is saved, configurations are added to the system for beacon deployment on the floors of each site. To administrate the MPact tree setup: ne 20 1. Select Tree Setup under the Operations main menu item.
2-8 Motorola Solutions MPact Location & Analytics Deployment Guide ne 20 14 3. From the Add Node dialog box, enter a node Name and select OK. 4. Continue adding nodes as required to the Floor level. 5. When finished, select Save. Ju Figure 2-7 MPact Server UI Tree Setup - Add Node Dialog Box D R AF T 2B -1 2 The newly created tree displays in the Tree Preview area. The node is automatically placed in its respective location the hierarchy in relation to the existing tree setups.
MPact Server Installation and Setup 2-9 2.4 Floor Plan Setup 14 After the tree setup is built down to the site floor level, load a Floor Plan image to the site’s Floor. A site can have multiple floors along with their floor plans. Optimally, a floor plan should be an accurate representation of the retail floor layout, which includes broad category labeling for items in the area. For example, a grocery store would have labels such as dairy, meats, vegetables etc.
2 - 10 Motorola Solutions MPact Location & Analytics Deployment Guide 2 Ju ne 20 14 4. Select the Load Map button to browse to and select a floor plan image of the site’s floor. -1 Figure 2-9 MPact Server UI Tree Setup - Load Floor Plan 5. Set the physical size of the area the floor plan represents: • Unit: Select either Meter or Feet. • Width: Enter the width of the floor, the default is set to 400. D R AF T 6. Select Save.
MPact Server Installation and Setup 2 - 11 2.5 Category Configuration 14 Use the Categories functions to group product family items logically and better apply significance to the locationing, customer traffic and dwell time data reported by the system. MPact events are tied to categories and category fields. When beacons are skillfully deployed, they are associated with the physical location of a specific product category within a floor plan.
2 - 12 Motorola Solutions MPact Location & Analytics Deployment Guide 2.5.0.1 Category Creation and Modification Ju ne 20 14 Use the +Create New Category button to add new categories to the Category List and the Edit drop-down menu to modify existing categories. To create a new category: -1 1. Select the +Create New Category button. 2 Figure 2-13 MPact Server - Category Creation and Modification AF T 2B 2. Enter a Category Name and Category Description and click Ok to implement the updates.
MPact Server Installation and Setup 2 - 13 2.5.0.2 Category Value Creation and Modification 2 Ju ne 20 14 Use the +Add New Value button to add new values to existing Category Values and the Delete drop-down menu to modify existing category values. Ensure any values added make up a logical group of products, well suited for the client traffic and dwell time reported under its parent category’s beacon deployment location.
Motorola Solutions MPact Location & Analytics Deployment Guide Copy Places a duplicate copy of the category value immediately below the existing category value. Delete Deletes the category value. 14 2 - 14 D R AF T 2B -1 2 Ju ne 20 4. Select Ok to implement the changes to the category value list.
MPact Server Installation and Setup 2 - 15 2.6 Beacon Place Holder Setup and Configuration 14 Use Place Holders to secure a beacon’s physical position on a site floor plan. The beacon place holder contains the beacon’s XAxis and Y-Axis coordinates and the beacon’s direction and antenna pattern. Ju ne 20 The optimal floor plan coverage has beacon place holders setup two meters apart and staggered on opposite sides of an aisle, seen in the image below.
2 - 16 Motorola Solutions MPact Location & Analytics Deployment Guide 2.6.1 Place Holder Manual Setup Manual place holder setup can be used for smaller deployments. 14 To manually set up a beacon’s place holder position: 1. Select Active View under the Locationing main menu. 20 2. From the Tree Hierarchy area on the left-hand side, select the System node to display the Unplaced Sites that have not yet been placed on the global map. 3.
MPact Server Installation and Setup 2 - 17 Ju ne 20 14 6. Select the Edit Mode button to the far-right on the tool bar. Figure 2-19 MPact Server - Floor Plan Edit Mode AF T 2B -1 2 7. From the Positions drop-down menu, select Add Position. 8. Select the intended location of the place holder by double-clicking on the location on the floor plan.
2 - 18 Motorola Solutions MPact Location & Analytics Deployment Guide -1 2 Ju ne 20 14 The Add Position dialog box displays with the Position Location auto-populated with the place holder’s X-Axis and Y-Axis positions on the floor plan. Figure 2-21 MPact Server Active View - Add Place Holder Position to the Site Floor 2B 9. Configure the Place Holder options: Enter a XX character maximum Position Name for the beacon place holder location.
MPact Server Installation and Setup 2 - 19 Antenna Pattern: Use the drop-down menu to set whether the antenna pattern is a Circle (360 degree omnidirectional) pattern or a Semi-Ellipse (180 degree direction) pattern. Beacon ID: The ID of the beacon receiving advanced settings. Degrees: Set from 0 to 360 degrees. Beacon Offset: Set from 1 to 4 meters. 14 Advanced Beacon Settings 20 10.
2 - 20 Motorola Solutions MPact Location & Analytics Deployment Guide -1 2 Ju ne 20 14 2. Select the Export/Import button. Figure 2-23 MPact Server System Maintenance- CSV Place Holder Import 2B 3. Select the Import button for Place Holder. D R AF T 4. When the Upload CSV popup box displays, browse to and select the CSV file, and select the Upload button. Figure 2-24 MPact Server System Maintenance - Upload CSV 5. Click Save to save CSV file data to the server.
14 20 ne CHAPTER 3 MPACT TOOLBOX INSTALLATION AND SETUP 2 Ju The MPact Toolbox is an iPad application designed for beacon installation and maintenance at the area beacons are deployed. The iPad is carried within the deployment area to scan a beacon’s barcode when the beacon is first installed to add its position attributes and validate existing beacons are working as expected.
3-2 Motorola Solutions MPact Location & Analytics Deployment Guide 3.1 Toolbox System Requirements The MPact Toolbox can be run with the following platforms: 14 • iOS versions 6.1 - Only supports the Battery Save beaconing mode • iOS versions 7.0 and higher - Supports all three MPact beacon modes (Battery Save, iBeacon and MPact) 20 3.1.
MPact Toolbox Installation and Setup 3-3 3.2 Toolbox Installation 14 The MPact Toolbox software application is installed on an iPad and is used to locate beacons in the system, download firmware to the beacons, and configure the beacons. The MPact Toolbox is used to maintain beacon positions and reconfigure beacons when changes are made to the retail site floor. The MPact Toolbox software application is installed on an iPad using the TestFlight web site (only for beta).
3-4 Motorola Solutions MPact Location & Analytics Deployment Guide -1 2 Ju ne 20 14 2. Select the Install button to install the TestFlight configuration profile on the iPad.
MPact Toolbox Installation and Setup 3-5 -1 2 Ju ne 20 14 3. Select the Install Now button to change the iPad settings. 2B Figure 3-2 MPact Toolbox Installation - Confirm Install Profile D R AF T 4. Select the Install Now button to install the profile settings on your iPad.
Motorola Solutions MPact Location & Analytics Deployment Guide -1 2 Ju ne 20 14 3-6 D R AF T 2B Figure 3-3 MPact Toolbox Installation - Profile Installation Confirmation
MPact Toolbox Installation and Setup 3-7 2B -1 2 Ju ne 20 14 5. Select the View All Apps button.
3-8 Motorola Solutions MPact Location & Analytics Deployment Guide 2B -1 2 Ju ne 20 14 6. Select the Continue button to agree to the Terms of Use & Privacy Policy Update.
MPact Toolbox Installation and Setup 3-9 2B -1 2 Ju ne 20 14 7. Select the Install button to install the Toolbox application. Figure 3-6 MPact Toolbox Installation - Install the Toolbox Application D R AF T 8. Select the Install button to continue with the installation.
3 - 10 Motorola Solutions MPact Location & Analytics Deployment Guide D R AF T 2B -1 2 Ju The application is installed on the iPad and ready for login. ne Figure 3-8 MPact Toolbox Installation Complete 20 14 9. Select the Continue button complete the installation process and open the application.
MPact Toolbox Installation and Setup 3 - 11 3.3 Toolbox Login and Setup 14 Login to the MPact Toolbox application to automatically allow the server to download deployment information to the Toolbox. All data displayed in the ToolBox is fetched from the server, which includes settings for site maps, floor plans, and beacon related configurations. To login to the MPact Toolbox application: 20 1. From your iPad, select the Toolbox icon.
3 - 12 Motorola Solutions MPact Location & Analytics Deployment Guide 3. Provide the numeric server IP address and port designated for traffic for MPact beacons. This is a non IPv6 address. The first time logging into the MPact Toolbox, the following are acceptable IP addresses for logging on to the server: 14 • http://IP/atls/atls/atls.html • http://IP:80/atls/atls/atls.html • https://IP/atls/atls/atls.html 20 • https://IP:443/atls/atls/atls.
MPact Toolbox Installation and Setup 3 - 13 Select Beacon Configure to wirelessly set the deployment settings for beacons. Settings Refer to the Settings option to administrate the connection settings between the handheld device and the MPact Server.
Motorola Solutions MPact Location & Analytics Deployment Guide D R AF T 2B -1 2 Ju ne 20 14 3 - 14
14 20 ne CHAPTER 4 BEACON INSTALLATION AND ACTIVATION For more information, refer to the following: 2 • Beacon Installation Ju The MPact Toolbox allows beacons to be installed and activated from the deployment site and allows the MPact Server to receive client device site data in real time.
4-2 Motorola Solutions MPact Location & Analytics Deployment Guide 4.1 Beacon Installation Use the iPad to scan the beacon’s bar code and connect the beacon to the floor plan location in the MPact Toolbox. 14 To connect the beacon hardware to the MPact Toolbox application: 1. From the toolbox home page, select Installation. D R AF T 2B -1 2 Ju ne 20 A global map displays the existing site locations. Figure 4-1 MPact Toolbox - Deployment Site Map 2.
Beacon Installation and Activation 4-3 -1 2 Ju ne 20 14 The Site Hierarchy screen displays deployment sites downloaded from the MPact Server. Figure 4-2 MPact Toolbox - Site Hierarchy 3. Select a site and drill down to the deployment floor plan where the beacons are being deployed. 4. Select the intended Place Holder for the beacon that is being deployed. D R AF T 2B The image below shows an empty circle on the floor plan with a red square, an intended Place Holder for a beacon.
4-4 Motorola Solutions MPact Location & Analytics Deployment Guide ne 20 14 5. With the MPact Toolbox set to scan mode, scan the bar code on the beacon housing by aiming the iPad camera within 3-4 inches of the beacon’s bar code until a green square appears. Ju Figure 4-4 MPact Toolbox Home Page - Beacon Place Holder 2B -1 2 A green square appears in the capture area and the decoded barcode displays as a numeric ID at the bottom of the page.
Beacon Installation and Activation 4-5 Ju ne 20 14 6. When the installation popup displays, select Scan Barcode. Figure 4-6 MPact Toolbox - Scan Barcode 7. Select Done, then select Save. -1 2 NOTE: If the beacons have been pre-configured on the server with a specific ID, be sure to select the proper beacon with the correct ID that matches what is shown on the beacon installation popup display. D R AF T 2B Within twenty seconds, the beacon connects to the toolbox.
4-6 Motorola Solutions MPact Location & Analytics Deployment Guide 4.2 Beacon Activation 14 After the beacon is connected to the MPact Toolbox, the beacon must be activated. The beacon is activated by opening and closing the beacon’s housing (hardware), where the battery is located. These actions allow the beacon to switch from transmitting mode to receiving mode, enabling the location and tracking of the client’s device, and allowing offers to be receive by the client’s device.
14 20 ne APPENDIX BEACON HARDWARE INSTALLATION Ju As a prerequisite to installing beacon hardware, the following setup processes must be complete: • MPact Server installation and setup is complete For more information see, MPact Server Installation and Setup on page 2-1 2 • MPact Toolbox installation and setup is complete For more information see, MPact Toolbox Installation and Setup on page 3-1 -1 For information on beacon power usage and scalability, see Beacon Battery Life For instructions on ins
A-2 Motorola Solutions MPact Location & Analytics Deployment Guide A.1 Beacon Battery Life Advertising Interval Broadcasting Power -4dBm +4 dBm [high] 200 ms 160 days 140 days 104 days 500 ms [short] 40 days 35 days 26 days 600 ms 1.9 years 1 year 300 days 1000 ms 1.2 years 1.7 years 1.3 years 2000 ms [long] 3.3 years 3 years ne 20 -30 dBm [low] 2.3 years Ju 2 -1 2B T AF R D 14 For beacon battery life information, refer to the following table.
Appendix A Customer Support A-3 A.
A-4 Motorola Solutions MPact Location & Analytics Deployment Guide A.
A-5 Ju ne 20 14 Appendix A Customer Support T 2B -1 2 Figure A-3 Universal Style Metal Bracket - Part Number MPACT-A1O10-004-WR AF Figure A-4 Universal Style Plastic Bracket with Beacon- Bracket Part Number MPACT-A1O10-001-WR To mount the universal style beacon to a Lozier shelf: 1. From the MPact Toolbox, select a site floor plan and beacon Place Holder location for the beacon installation. D R 2.
A-6 Motorola Solutions MPact Location & Analytics Deployment Guide A.4 Beacon Hardware Regulatory Information 14 This device is approved under Motorola Solutions, Inc. This regulatory information applies to the following Model Numbers: ATLS-T1B. All Motorola devices are designed to be compliant with rules and regulations in locations they are sold and will be labeled as required. 20 Local language translations are available at the following web site: http://portal.motorolasolutions.
Appendix A Customer Support A-7 Safety in Aircraft 14 Switch off your wireless device whenever you are instructed to do so by airport or airline staff. If your device offers a flight mode or similar feature, consult airline staff as to its use in flight. Figure A-7 RF Exposure Guidelines Reducing RF Exposure - Use Properly 20 Safety Information ne Only operate the device in accordance with the instructions supplied.
A-8 Motorola Solutions MPact Location & Analytics Deployment Guide Radio Transmitters (Part 15) 14 This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
A-9 ne 20 14 Appendix A Customer Support Ju Figure A-11 China RoHS Customer Support Web Site -1 2 If you have a problem with your equipment, contact Enterprise Mobility support for your region. Support and issue resolution is provided for products under warranty or that are covered by an Enterprise Mobility Services agreement. For information and online assistance including developer tools, software downloads, product manuals, support contact information and online repair requests.
A - 10 Motorola Solutions MPact Location & Analytics Deployment Guide Other Licenses 20 14 The following indicates that this product is licensed to operate according to Apple's iBeacon specifications.
14 20 ne APPENDIX CUSTOMER SUPPORT Ju Motorola’s Enterprise Mobility Support Center 2 If you have a problem with your equipment, contact Enterprise Mobility support for your region. Support and issue resolution is provided for products under warranty or that are covered by an Enterprise Mobility Services agreement. Contact information and Web self-service is available by visiting http://portal.motorolasolutions.com/Support/US-EN.
Motorola Solutions MPact Location & Analytics Deployment Guide D R AF T 2B -1 2 Ju ne 20 14 B-2
T AF R D 2B 2 -1 ne Ju 14 20
14 20 ne Ju 2 -1 2B T R AF Motorola Solutions, Inc. 1301 E. Algonquin Rd. Schaumburg, IL 60196-1078, U.S.A. http://www.motorolasolutions.com D MOTOROLA, MOTO, MOTOROLA SOLUTIONS and the Stylized M Logo are trademarks or registered trademarks of Motorola Trademark Holdings, LLC and are used under license. All other trademarks are the property of their respective owners. © 2014 Motorola Solutions, Inc. All Rights Reserved.