Zebra CLAS Software Real-Time Locationing System (RTLS) Demo Application User Guide

Real-Time Location System (RTLS)
Demo Application
User Guide
MN-003509-01 Rev A
Copyright
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2020 Zebra Technologies Corporation and/or its affiliates. All rights reserved.
COPYRIGHTS & TRADEMARKS: For complete copyright and trademark information, go to
www.zebra.com/copyright
.
WARRANTY: For complete warranty information, go to www.zebra.com/warranty
END USER LICENSE AGREEMENT: For complete EULA information, go to www.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.
.
.
Revision History
Changes to the original guide are listed below:
Change Date Description
Rev A -01 Feb 2020 Initial Release.
2
Contents
About This Guide ............................................................................................................................... 5
Chapter Descriptions ....................................................................................................... 5
Notational Conventions ................................................................................................... 5
Related Documents ......................................................................................................... 6
Service Information ......................................................................................................... 6
Provide Documentation Feedback .................................................................................. 6
Getting Started ................................................................................................................................... 7
Overview ......................................................................................................................... 7
Installing the RTLS Demo Application ............................................................................. 7
Launching the Application ............................................................................................... 8
Page Navigation .............................................................................................................. 8
Searching ................................................................................................................ 9
Map Layers and Filtering ....................................................................................... 10
3D Navigation ................................................................................................................ 10
Using Live View ............................................................................................................................... 12
Overview ....................................................................................................................... 12
Viewing Tag Details ...................................................................................................... 13
Layers and Filtering ....................................................................................................... 14
Viewing Kafka Messages .............................................................................................. 15
Tag Movement .............................................................................................................. 16
Tag History ....................................................................................................................................... 17
Displaying Historical Tag Data ...................................................................................... 17
Viewing Tag History Details .......................................................................................... 17
Historical Playback ........................................................................................................ 17
Multiple Tag Playback ................................................................................................... 19
Playback Selected Tag History ..................................................................................... 19
3
Contents
Exporting Tag History .................................................................................................... 19
Configuring the Application ........................................................................................................... 20
Creating a Tag Association and Tag Type .................................................................... 20
Visualization .................................................................................................................. 21
Setting Show Tag Movement ................................................................................ 21
Setting Remove Tag Threshold ............................................................................. 22
Facility Configuration ..................................................................................................... 23
Importing a Facility Map ........................................................................................ 23
Reporting Thresholds .................................................................................................... 24
Resetting to Factory Defaults ................................................................................ 25
Alerting ......................................................................................................................... 26
Configuring Alerts .................................................................................................. 26
Advanced Functions ....................................................................................................................... 27
Recording a Map ........................................................................................................... 27
Downloading a Video ............................................................................................. 28
Discarding a Video Recording ............................................................................... 28
Exporting Data .............................................................................................................. 29
Static (Reference) Tag Analysis .................................................................................... 30
Uploading a Reference Tag ................................................................................... 30
Viewing Reference Tags ....................................................................................... 30
Historical Playback ................................................................................................ 32
Dynamic Tag Analysis (Walking Paths) ........................................................................ 33
Uploading a Walking Path ..................................................................................... 33
Viewing a walking path .......................................................................................... 33
RTLS and ATR Diagnostics .......................................................................................... 35
Viewing and Downloading RTLS System Information ........................................... 35
Viewing and Downloading ATR7000 Device Information ...................................... 35
4

About This Guide

This guide provides information on the RTLS Demo Application, a visualization tool that facilitates locating and tracking Radio-Frequency Identification (RFID) tags within a facility using Zebras ATR7000 hardware and Configuration and Location Analytics Software (CLAS).
NOTE: Screens and windows pictured in this guide are samples and can differ from actual screens.

Chapter Descriptions

Topics covered in this guide are as follows:
Getting Started provides an overview of the RTLS Demo Application and general features of how to
launch and navigate through the views.
Using Live View describes how to visualize and obtain tag data within the coverage area of an RTLS
deployment.
Tag History describes the historical data of tag location and movement over time.
Configuring the Application provides information about tag association, visualization, facility
configuration, and alerting.
Advanced Functions provides information about recording, exporting data, static and dynamic tag
location analysis, how to obtain ATR and RTLS diagnostics, and statistics.

Notational Conventions

The following conventions are used in this document:
Bold text is used to highlight the following:
Key names on a keypad
Button names on a screen.
Bullets (•) indicate:
Action items
Lists of alternatives
Lists of required steps that are not necessarily sequential
Sequential lists (for example, those that describe step-by-step procedures) appear as numbered lists.
5

Related Documents

CLAS Server and Software Installation Guide.
About This Guide
For the latest version of this guide and all guides, go to: www.zebra.com/support

Service Information

If you have a problem using the equipment, contact your facility's technical or systems support. If there is a problem with the equipment, they will contact the Customer Support Center at: www.zebra.com/support
When contacting 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, telephone or fax within the time limits set forth in service agreements.
If your problem cannot be solved by 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 business product from a Zebra business partner, please contact that business partner for support.

Provide Documentation Feedback

If you have comments, questions, or suggestions about this guide, send an email to
EVM-Techdocs@zebra.com
.
.
.
6

Getting Started

Overview

The Real-Time Location System (RTLS) demo application is a visualization tool that provides locationing insights for RFID tagged assets within the coverage area of a facility where ATR7000 readers and CLAS software are deployed. The tool consists of a real-time engine that consumes up to 1000 location messages per second and visualizes RFID tags in a 2D or 3D space. The application can also record and replay tag location history and movement during a user-defined time frame.
Figure 1 Landing Page
Search
Tabular Listing
2D/3D Map Visualization Map DimensionsNavigation Drawer

Installing the RTLS Demo Application

Layers
Filters
Rest Map View
Zooming Record
Navigate to previous or next page
The RTLS Demo Application is automatically included in every RTLS/CLAS software installation. For installation instructions, refer to the CLAS Server and Software Installation Guide (see Related Documents
on page 6).
7

Launching the Application

The RTLS Demo Application consists of a real-time backend engine that is a consumer of the Kafka messages (tag location updates) published by the CLAS software and a frontend accessed through a browser. Prior to launching the demo you must ensure that the backend engine is enabled. This is described in the Starting and Stopping RTLS section in the CLAS Server and Software Installation Guide (see Related Documents on page 6), using the -d switch in the command line when starting RTLS.
1. Ensure that the RTLS is stopped prior to starting.
2. To start RTLS including the backend engine, type one of the following commands:
./rtls.sh -ndk start - To use the embedded NTP server and Kafka broker.
./rtls.sh -nd start - To use the embedded NTP server when running an alternative Kafka
broker.
./rtls.sh -dk start - To use the embedded Kafka broker with an upstream NTP server.
./rtls.sh -d start - To use the demo application with an upstream NTP server and alternative
kafka broker.
3. Open an Internet browser.
4. In the address bar type the URL of the RTLS Demo Application https://<rtls_server_ip>:<port>/, and
press Enter. The variables in the URL must be substituted with appropriate values assigned during RTLS deployment. The port variable must also be replaced with the port specified in the .env file during RTLS deployment described in the CLAS Server and Software Installation Guide (see Related Documents on
page 6).
Getting Started
NOTE: The default deployment of RTLS enables https. If RTLS Services software is deployed with https disabled (SSL_ENABLE option set to NO), then https must be changed to http.
The RTLS Demo Application is compatible with a wide range of browsers, however, for best performance, Zebra recommends using Firefox, Google Chrome, or Microsoft Edge.

Page Navigation

Navigate the RTLS Demo application using the Navigation Drawer .
Click and a fly-out menu displays. From the navigation menu, you can access the Live View, Tag History, Configuration, Diagnostics, Validation screens, and the User Guide. Click to close the menu.
8
Figure 2 Fly-Out Navigation Menu
Getting Started
After launching the application, the landing page is in Live View. Live View provides a real-time visualization of tags within the coverage zone of a facility. In Live View you can select a tag and query information about its Electronic Product Code (EPC) ID and location, search for specific tags via EPC ID, filter by tag type, and a number of other functions. In Live View the screen is divided into two areas; the Map View and Tabular List View. The Map View visualizes all tags within the coverage zone of a facility, and the Tabular View provides tag details in spreadsheet format that includes location, timestamp, and confidence.

Searching

To search for a specific tag in Live View, locate the Tag Search box in the upper left portion of the Map View. Enter any contiguous portion of an EPC, and press Enter. The tags visualized in the Map View and Tabular View are limited to those tags where any portion of the EPC matches the entered string.
Figure 3 Search Icon
Search icon
9
Figure 4 Clear Search

Map Layers and Filtering

The appearance of the map stage and the content displayed on the map can be filtered using the icons located in the upper-right of the map area.
Click to launch a menu to apply simple, pre-defined filters that display only those tags in specific states. When a filter is active, it displays as a glowing icon.
Click to launch the Layers menu. The Layers menu allows pre-defined images to appear on the screen. The most common images uploaded are an image showing ATR location and an image of the facility map.
Getting Started
Click X to clear the search and reset the dataset.
The Filter and Layers menu are described in Layers and Filtering on page 14.

3D Navigation

The map stage in Live View can be rotated from an overhead (2D) view to a 3D tilted perspective, using the right mouse button. Similarly, the left mouse button is used to pan the scene in a horizontal and vertical orientation. Zooming in or out is accomplished using the scroll wheel.
Figure 5 3D Navigation
Pan Map
Zoom
Rotate Map
The controls on the lower-right of the map allow direct input across to pan and zoom.
10
Reset Map View
Zoom Map
Getting Started
Figure 6 Zooming to view Tag Rendering
Maximum zoom in and out constraints are built into the interface. To maintain a good field of view for rendering the tags, these constraints prohibit zooming too far out or too close.
11

Using Live View

Overview

In Live View, the top panel of the screen provides a real-time 2D or 3D visualization of all RFID tags within the coverage area of a deployed RTLS system, consisting of one or more ATR7000 readers and CLAS software. The map panel is refreshed 10 times per second.
Figure 7 Live View
In Live View, the lower panel of the screen below the map stage, is a tabular representation of the same displayed tags. All tags filtered in map view are also filtered in the tabular listing. The tabular view provides detailed information about each tag without needing to click the tag object on the map.
By default, the tabular listing is configured to display tag details. The tabular listing section can also be configured to display raw location messages or only moving tags.
NOTE: The tabular listing is updated two times a second, regardless of the rate that the messages are being ingested from the CLAS software.
12
Figure 8 Tabular Listing View
Using Live View
Live Kafka Messages
Tags within the Facility
Show/Hide tag on the Map
Message Consumption Rate
Moving Tags
Tag Data for each Item
Tag Count and Number of Moving Tags
Expand/Contract Map View
Table Pagination

Viewing Tag Details

Clicking a tag object on the map focuses (zoom) the map on that specific tag and follows it as it moves. The highlighted tag also displays an information card with its EPC ID, real-time location, a last seen (timestamp), and a list of ATR readers that are reading the tag (if enabled in the Configuration > Reporting Thresholds menu).
While in this view you can also access the tag location history. Clicking View Location History exits map view and displays the history page of the tag. More information about the features available when viewing location history are described in Tag History.
You can also view tag details by clicking a tag line item on the tabular view to focus the map on that specific tag, and follow it as it moves. Selecting that same row in the table again de-selects the tag, and hides the information card.
NOTE: Only one tag can be focused on at one time.
13
Using Live View
Figure 9 Single Tag View
Click X to Close the Info Card
Click View Location History to display the history page with this tag detail selected.

Layers and Filtering

The RTLS Demo Application allows importing a facility map that can be displayed on the map stage in Live View. See Importing a Facility Map on page 23 on how to import a facility map. In addition, the location of the ATR7000 readers as defined by the RTLS system configuration files is included as a pre-defined layer.
Two other special cases that utilize the layer function are described in Advanced Functions on page 27 to define reference tag locations and a walking path, which can be used to validate an RTLS deployment. Once these (and other) layers are defined, the map stage and content displayed on the map can be filtered using the icons located in the upper-right of the map area.
Click to reveal the Layers menu. On the Layers Menu you can show or hide all defined layers by selecting or de-selecting the corresponding check boxes.
NOTE: Figure 10 shows an example of the map and ATR objects being hidden from the 2D and 3D view.
Selecting specific EPC types also shows or hides them from the tabular listing in Figure 17.
Similarly, the RTLS Demo Application allows you to define tag (asset) types that can be selectively displayed or hidden. Click to reveal the Filters Menu. On the Filters Menu, show or hide the specific product types by selecting or de-selecting the corresponding check box. These selections are also reflected in the tabular view.
The process of defining custom tag types is described in Creating a Tag Association and Tag Type.
14
Using Live View
Figure 10 Layers Menu
Figure 11 Filters Menu – Example showing Selecting on specific Product Tag Types to View

Viewing Kafka Messages

The Kafka messages panel displays the raw messages from the RTLS server. Any filtering parameters that have been applied in previous steps also apply to messages that are displayed. When no filtering is enabled, the location messages for all visible tags are displayed.
15
Using Live View
Figure 12 Kafka Messages Panel
Figure 13 Kafka Messages from Tags on Map

Tag Movement

Click the Tag Movement tab to display only those tags that are currently moving within the facility. The tag movement status is a parameter included in each location message and is determined based on thresholds configured in the CLAS software. Each tag is listed here in card format, where you can click to get additional details on the tag.
NOTE: In order to display moving tags in the Tags on the Move panel, the CLAS software must be configured to report movement metadata in the location messages. Otherwise, tags that are moving do not display. Refer to Reporting Thresholds on page 24 to configure the CLAS software to report movement metadata in the location messages.
16

Tag History

Displaying Historical Tag Data

In addition to live data, the RTLS Demo Application allows you to view tag history. Tag History allows you to search for a tags’ EPC ID values, filter by recent tag activity, or filter by type (project, pallet or forklift). You can also filter by time by clicking in the right corner of the tab.
1. Click > Tag History. By default, all tags are displayed in the bottom panel of the screen.
2. To view a subset of the data, enter any portion of a Tag EPC ID in the Tag Search field.
3. From the Showing Only drop-down list select whether to Show All Tags, Tags that are moving, or
Tags that have never moved.
4. From the Showing Tag Type drop-down list select whether to All Types or other tags that you have
defined in the system.
Figure 14 Tag History

Viewing Tag History Details

Selecting a row on the Tag History table opens up a panel that displays all the movement positions over time for the history of that tag. Due to database limitation, the amount of historical tag data stored is limited to one hour. If a tag has never moved, there will only be two entries in the table in tag playback view, the first time seen, and the last time seen.

Historical Playback

Click Play in the History Playback View to animate the tag’s position over time. To view a time of interest, the timeline can be moved forward or backward. If configured (refer to Setting Show Tag Movement on
page 21), then a movement trail will follow the tag indicating historical tag location over the course of the
recorded time frame.
As messages continue to come in real-time, the last seen data, along with the most recent location data, is constantly updated.
17
Figure 15 History Playback View
Tag Positions
Tag History
Movement Trail
NOTE: The timeline illustrates the starting and ending time of a historical timeframe. Timeframes with active location updates are illustrated as tick marks on the timeline.
Click Clock to speed up or slow down the playback. The default speed is 32x. The speed can be in real-time, for example, 1s = 1s, or 512x normal time. As the tag moves, a movement trail is shown behind it. This trail length is configured through the Visualization on page 21 menu. Click Stop to stop the playback at any time. The blue playback bar displays the current time stamp of the playback, with the current time indicated in white.
As the tag moves, a movement trail is shown behind it. This trail length is configured through the Visualization panel using the Configuration feature. Once animating, you can stop the playback by clicking Stop. The blue playback bar displays the current time stamp of the playback, with the current time indicated in white.
Figure 16 Playback with Movement Trail
Movement Trail
18

Multiple Tag Playback

From the Tag History screen, you can select individual or multiple tags by selecting or de-selecting the check boxes to the left of the Tag ID column. Selecting multiple check boxes allows you to view the playback of multiple tags simultaneously.

Playback Selected Tag History

Click Playback Selected History to launch a panel where you can select or de-select tags to play back.
You can also manage the time line of the tags to view a specific timeframe of interest.
Figure 17 Playback Selected Tag History
Tag History
Historical locations for the selected tag(s) over time viewed on the map panel.
Historical locations for the selected tag(s) over time in tabular format.
NOTE: If a tag has never moved, there are only two entries in the table in tag playback view, the first time seen, and the last time seen.

Exporting Tag History

To export data:
1. Click .
2. Select to either export Current Tag Location Data or All Historical Location Data.
3. Select to either export to CSV, EXCEL, or PDF.
You can also record the Tag History panel, similar to the Grouped Tag History and Live View pages.
19

Configuring the Application

The RTLS Demo Application can be configured to create unique visual attributes customized to suit a variety of applications. At a high level the menu allows you to configure Tag Association, Visualization, Facility Configuration, Reporting Thresholds, and Alerting.
Through the Configuration menu you can specifically:
Define specific attributes to create various tag types.
Set parameters and thresholds that determine how tags are displayed in Live View and Tag History
view.
Define facility information and import maps.
Set reporting thresholds.
Figure 18 Configuration Landing Page

Creating a Tag Association and Tag Type

The Tag Association option allows you to associate specific EPC patterns with a variety of pre-defined and custom tag types. Once you select a tag type, an EPC association of that type appears, along with its associated color.
To create a new Tag Type and add corresponding tag associations:
1. Click > Configuration, and then Tag Association. The screen displays three pre-defined tag
types (forklift, product, and pallet), and any other custom defined tag types that have been previously defined.
2. In the Tag Types area, click Create New to create a new tag type.
20
3. Enter a new tag name, and press Enter.
4. In the Tag Association area:
a. Under EPC Association, click Create New.
i. Enter an EPC Pattern that will uniquely define this tag type, and press Enter. Adding a pattern
here now associates any EPC ID that contains this string to this Tag Type.
b. In the Type Color drop-down list, select a color to associate to this tag type to annotate tag objects
with a specific color, if desired. If no color is selected, the default color is white.
c. In the Icon area drop-down list, select an icon to associate to this tag type.

Visualization

This section describes how to configure various tag visualization features. You can configure how to monitor tag movement by selecting to highlight tags on the move, set the number of recorded positions in the tag’s movement trail, and configure the time threshold that tags are removed after they cease being reported by the RTLS system.

Setting Show Tag Movement

Configuring the Application
The RTLS system sends location messages with metadata that indicate when a tag is on the move. By enabling this setting in the configuration, the rows in the tabular listing Live View are highlighted when a corresponding tag is on the move.
To enable tag movement visual effects:
1. Click > Visualization.
2. In the Show Tag Movement area, check the Highlight tags on the move box.
3. In the Show Movement Trail area, specify the time (in seconds) to display last reported position of the
tag. The value must be between 2 and 10 seconds. Once enabled, the path of the tag being played-back (in Tag History) has a trail the length of its last 10 positions.
21
Configuring the Application
Figure 19 View Movement Trail
Turning on the movement trail and adding a larger value shows the trail of the tag in the playback.
Turning tag movement trail off displays a single datapoint without movement.
Figure 20 Tags on the Move Parameters

Setting Remove Tag Threshold

When these boxes are not checked, the Tag Movement tab will not show up in Live View.
If a tag is not reported after a user-specified amount of time, it is removed from the map. Objects on the map are not updated until a new message for that specific tag comes through the message (Kafka) queue, this option allows for the removal of tags after a user-specified amount of time if the tag has gone out of view or is no longer being read by the RTLS system.
To remove a tag threshold:
22
1. Click > Visualization.
2. In the Remove Tag Threshold area, specify the time (in seconds) to remove tags from the Live View.

Facility Configuration

This section explains how to configure the facility name, map image, and timezone of an RTLS deployment.
1. Click > Facility Configuration.
Figure 21 Facility Configuration Page
Configuring the Application
2. In the Facility Info area, specify the name of the facility environment to be shown in the header of the
application, and click APPLY.
3. From the drop-down list, select the timezone setting for the application to use for time formatting.
Figure 22 Example Facility Map

Importing a Facility Map

The application supports the capability to import a facility map as a layer that can be viewed or hidden using the Layers menu. The extent of the Map view is based on the locations of the ATRs and is computed to ensure that all ATRs is visible. A margin around the perimeter of the ATRs approximately equal to the half of average spacing of the ATRs is added. The total x-y dimension of the map stage is shown in the Map Dimensions section of the map stage in Live View.
3D Map
2D Map
23
Before importing a facility map, it is important that the dimensions of the map are as close as possible to the dimensions of the map stage in Live View, otherwise there is a slight distortion between the visualization and the actual facility. Therefore, it is strongly recommended to crop the facility map image using a graphics editor (for example, Microsoft Paint) to match the map layer to the ATR layer as closely as possible.
To import a facility map:
1. In the Facility Map area, click Choose File to upload an image of the facility. Only .png and .svg
formats are supported. The selected map changes the texture used on the 2D/3D stage. This map represents the actual facility.
2. Click UPLOAD. The ATRs area displays the RTLS ATR hardware units and locations for this facility.
NOTE: Facility maps using only .png and .svg formats are supported.

Reporting Thresholds

This section explains how to configure miscellaneous CLAS software parameters and reporting thresholds, and how to revert to RTLS Demo Application default settings.
Configuring the Application
The Reporting Thresholds area allows you to configure the CLAS software for two reporting thresholds. One threshold limits how often the CLAS software sends a location message for each tag, regardless of movement status. The second threshold sets the distance that a tag must move to send a tag location update message. Together these thresholds can manage the frequency of the messages sent by the RTLS system.
1. Click > Reporting Thresholds.
2. In Report bearing, specify the time (in seconds). Regardless of movement activity, the CLAS software
sends a location message update based on this timer. Setting this parameter to 0 causes CLAS to send a location update message every time a tag is read.
3. In Report bearings when tag moves, specify the distance (in feet). When a tag moves this distance, a
message is sent separate from the time-based reporting threshold message. Setting this parameter to 0 causes CLAS to send a location update message every time a tag is read.
4. Click APPLY THRESHOLDS.
Miscellaneous Configuration Parameters
Check the Enable static or dynamic metrics in feed. Once this option is selected, the messages from
the CLAS software contains movement information that is required to show tags on the move.
Check the Enable reader reporting in feed. Once this option is selected, the messages from the
CLAS software contains the reader IDs that reported the tag location, and it annotates which readers or ATRs reported a selected tag.
24
Configuring the Application
Figure 23 Reporting Thresholds Configuration Page

Resetting to Factory Defaults

Click RESET TO FACTORY DEFAULTS to revert the application to the original default settings.
The ATRs area displays the RTLS ATR hardware units and locations for this facility.
25

Alerting

There are two configurable alerts for the RTLS Demo Application:
If the tag is not seen in a set amount of time.
If there is no movement for a set length of time.

Configuring Alerts

To configure alerts:
1. Click > Configuration > Alerting.
2. Check the If the tag as not been seen in ____ seconds box, and enter the time (in seconds). Once
this option is selected, the Live View and Tag History panel annotates tags that have not been seen within the last 60 seconds.
3. Check the If the tag as not been moved in ____ seconds box, and enter the time (in seconds). Once
this option is selected, the Live View and Tag History panel annotates tags that have not been moved within the last 60 seconds, based on the system's movement thresholds.
Figure 24 Configuration - Alerting
Configuring the Application
Tags that have not been seen are represented by Clock icons.
When both instances occur at the same time, the icons are displayed next to each other.
Tags that have not moved in a certain amount of time are indicated by a Not Moving icon.
26

Advanced Functions

Recording a Map

Video recording is a useful tool for capturing walking tests when deploying an RTLS system. Using the capture function is also useful when highlighting events in the system for off-line presentation. Click Record in the lower-right corner of the page on the Live View panel to start a screen capture of the map in view. The system records the tracking and rotation of the map, and the movement of the tags in real-time up to 8 fps, and a maximum length of 120 seconds. Once you click Record, the circle turns into a square to indicate that a recording is in progress.
Figure 25 Live View Video Recording
Record Button
Click Stop to stop the recording, and the frames are processed. A preview dialog displays, where you can playback the video that you just captured.
27
Figure 26 Video Recording Preview

Downloading a Video

Advanced Functions
Click Download Video to encode the video frames and initiate a download in MP4 format.
Figure 27 Encoding Video

Discarding a Video Recording

When Discard is selected, the system displays a warning that the data capture is lost without the possibility of retrieval. To proceed, select Clear Current Capture.
28
Advanced Functions
Figure 28 Discard Video Recording

Exporting Data

Every tag location message that was received during the recording is also captured. Click Export Data to download these messages into a .txt file onto your computer. The downloaded file contains raw messages that reflect the video capture.
Figure 29 Messages Received During Recording
29
Advanced Functions

Static (Reference) Tag Analysis

Reference Tags are a feature that can be used as a validation mechanism after an RTLS system has been deployed. Reference tags are fixed RFID tags at known locations in a facility, which serve as reference points for calibration and system validation. Known reference tags are statically placed in the facility at absolute positions to test the accuracy of the detection algorithm. Multiple tags can be referenced in a reference tag data set.

Uploading a Reference Tag

1. Click > Validation. By default, the Walking Paths page displays.
2. On the left pane, click Reference Tags.
3. Enter a name for the reference.
4. Enter a description for the reference. (Optional)
5. Paste the CSV data for the reference tags in the following format:
epc_id, x, y, z
6. Click UPLOAD TAG LIST. Once uploaded, the reference tag list appears in the lower panel. The
reference tags are now available from the Layers menu on the Live View page.
7. To remove a reference tag list, click Remove Reference Tag File.
NOTE: You cannot edit a reference tag once it is uploaded.

Viewing Reference Tags

1. On the Live View page, click and check Select Reference Tags.
2. Click the arrow to Select Reference Tags.
Figure 30 Live View - Layer Menu
Circles mark the spot for which a tag should be positioned, the circles match the tag type color.
30
Advanced Functions
Figure 31 Live Map
The live table shows only the tags referenced in the import. Any deviation from the tags reference point are displayed as the error value.
Figure 32 Live Table
When one of the rows is selected, the tag detail panel displays the error and reference tag’s x and y position in real-time, enabling you to track the accuracy of the recorded tag.
Figure 33 Reference Point Error
The error of 4.81 means that the tag is 4.81 feet away from the expected reference point. Only x and y are considered when calculating the error value.
The Layers menu is visible on the Tag History panel giving you the ability to show or hide reference tag and walking path data sets on the playback map.
31
Figure 34 Layers Menu
Advanced Functions

Historical Playback

NOTE: The tags on the historical playback map are only used for reference and do not filter the data based
on layer selection as it does on the Live View page, where the validation layers are used for real-time analytics.
Figure 35 Historical Playback Map
When a walking path is selected, the visualization appears as shown in Figure 36.
32
Advanced Functions
Figure 36 Historical Playback - Walking Path View

Dynamic Tag Analysis (Walking Paths)

A Walking Path is a feature that can be used as a validation mechanism after an RTLS system is deployed to perform dynamic tag analysis, it is also a series of paths in CSV format that forms a pre-determined route, which a tag moves over a specified period of time. This feature can be used to determine the accuracy of a real-life tag while in motion along a known path.

Uploading a Walking Path

1. Click > Validation. By default, the Walking Paths page displays.
2. Enter a name for the path.
3. Enter a description for the path. (Optional)
4. Paste the CSV data for the walking path in the following format:
epc id, start time, start_x, start_y, start_z, end_time, end_x, end_y, end_z
5. Click UPLOAD PATH. Once uploaded, the path appears in the lower panel. The walking path is now
available from the Layers menu on the Live View page.
6. To remove a path, click Remove Reference Tag File.
NOTE: You cannot edit a path once it is uploaded.

Viewing a walking path

1. On the Live View page, click and check Select Walking Path.
2. Click the arrow to select a walking path. Once you select a Walking Path from the drop-down, the
system renders the path as a dotted line on the 3D map. The tag inherits the color of the tag type, and displays only the associated tag or tags on the map. In the lower pane, the table displays the associated tag with the walking path dataset, and also provides a live error reading that shows how far from the line the tag is.
33
Advanced Functions
Figure 37 Select a Walking Path
Figure 38 Walking Path Visualization
Figure 39 Tag Details Table
For walking paths, the actual x and y coordinates are shown next to the reference x and y coordinates. Ideally, the real tag should be on the line with an error reading as close to 0 as possible.
34
Advanced Functions

RTLS and ATR Diagnostics

You can view the RTLS system-wide server status, versions, and configurations, as well as the ATR device versions, and health status. You can view specific tags searching or filtering by type or recent movement history.

Viewing and Downloading RTLS System Information

1. Click > Diagnostics. By default, the CLAS Status page appears, displaying server memory, CPU
usage, tracked tags, error counts, and warning count information. In addition, similar statistics are displayed for the ATR-based components: Radio C&D and Location Analytics.
2. Click the CLAS Versions tab to view the Release Package or C&M versions, or the CLAS
Configuration tab to view configuration, licensing, report filtering, and the associated Kafka broker
addresses.
3. On any of the pages, to download a snapshot of the hardware status for the RTLS System, click .
4. Click EXPORT DIAGNOSTIC SNAPSHOT. A .json file is downloaded to your computer, and you can
view the file offline.

Viewing and Downloading ATR7000 Device Information

1. Click > Diagnostics. By default, the CLAS Status page appears.
2. On the left pane, click ATR Devices. The ATR Status page appears displaying hardware information.
RAM and CPU performance is displayed by a dough nut graph, and is color coded based on utilization.To view networks, location, and versions, click the ATR Versions tab.
3. On either page, in the Find ATR Hardware field, you can search for specific ATR’s by host address
4. On any page, to download a snapshot of the hardware status for ATR Devices, click ,
5. Click EXPORT DIAGNOSTIC SNAPSHOT. A .json file is downloaded to your computer, and you can
view the file offline.
35
www.zebra.com
Loading...