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...