Pixie RTLS Sample App


Pixie RTLS Sample App Overview

The RTLS Sample App requires the following:

  • iOS device with Pixie App installed.

  • PC/Mac with Chrome browser.

  • 4 Pixie Points – make sure you have only 4, more Points configuration is not supported on the demo App

  • Internet connection

 

The RTLS sample App is an Add-on App. This means that Pixie Points are set in the Pixie App (adding points and pairing). RTLS sample App will use the exact same Pixie Points.

If you do not have Pixie App installed start here:

  1. Download the Pixie App from the App store.

    Search Pixie Finder in the App store, or use this link:
    https://itunes.apple.com/us/app/pixie-find-lost-things-keys-wallet-luggage/id963709071?mt=8

  2. Open Pixie account in the Pixie App.

  3. Pair 4 Pixie Points to the phone (follow the App instructions).

  4. With each Point paired to the account you will assign a name.
    Names you provide to the Points are used by the Pixie App but aren’t used by RTLS Sample App.

 

The iOS device and the laptop need to be connected to the internet to run the setup as they connect via the cloud and not directly by local WIFI.

Position anchor (static) tags as follow:

  1. Height: 2.5m

  2. In a triangle shape, Ideally create equilateral triangle, but not a must. 

Dynamic Point is hand-held at approximately 1.1m

The image below shows the environment setup for the RTLS sample App (colors of points are for illustration only)

app3.png

Components Placements and
App UI Cross Reference

table.png

High-level Sequence of Operation

 

  1. Download the sample App to the iOS device.
    Note: You need to approve Pixie Technology as trusted App as this is not downloaded from the App store. See detailed explanation and process at https://support.apple.com/en-us/HT204460

  2. Connect the relevant Points (the one to work with in the RTLS demo).

  3. Select the 3 static Points and the one moving Point out of the connected Points.

  4. Start the session on the iOS device – get session ID.

  5. On the Chrome web client (provided by Pixie)

  • Unzip the package to your local drive.
  • Enter the session ID.
  • Make rough placement of the Points on the client side.
  • Start the session to see locations.

Comments:

  • Please use this demo App with 4 Pixie Points only. Remove other points from the Pixie App before you start.
  • WebClient is supported with Chrome browser only.

Step by Step Instructions

  1. Have 4 Pixie Points paired with your Pixie App. Remove other Points from the Pixie App before you start.
  2. Download Sample App to your iOS device click here
    Note: Like any App that is not downloaded from the App store, you need to approve Pixie Technology as trusted Enterprise App. See details here
    The version in the download link is: 1.1.0(13)
  3. Log in with your Pixie Email/Password
  4. Now you should see your paired points (but without the names that are given on the Pixie App
    Note: The Points are identified by their MAC addresses. To identify and extract a specific Point MAC address, see instructions at the end of this document.
  5. Click retrieve to reset the points.
  6. To connect to your points, click Change Connection.
  7. Set “Coordinator” to one of the static Points. If one Point is more centered than the other better to have this one as the Coordinator.
  8. ‘Select’ the 3 other Points to connect
  9. The selection of specific coordinator vs the other Points is not important for the RTLS demo App. See image A below.
  10. Press Connect.
    This will connect all the relevant points in bulk as a network with the coordinator you chose.
    The Connection Screen will disappear and navigate you back to the main screen Point List Screen

  11. Connected Points will get the “live” color and Range button.
    Press the Range button to see the ranges measurements from this Point to all other Points it is connected too. See image B below.

  12. "Try RTLS Button" is enabled only when 4 points exactly (and no more) are connected. 3 points will be used as anchors (static) and 1 Point is the moving object called "Desired". See image B below.

  13. Click “Try RTLS” - the RTLS Selection Screen will appear. See image C below. 

    1. To designate the Dynamic Point -  click on “Desired”.

    2. To select a point as an anchor, click “Include”. 

    3. To un-select a point click “Exclude”.

  14. Then Click "Start" and that's it!

Image A

Image A

Image B

Image B

Image C

Image C


Web Client

Download Web client from zip: Download WebClient RTLS

Note: This client is working on Chrome browser only.

  1. Unzip the package into your local drive.

  2. Open index.html (requirement: from any PC/Mac on Chrome)

  3. Enter the RTLS session number (form the iOS device), to connect to the cloud and get the location data. See image D below.

  4. Anchors tags appear as squares with their respective colors

  5. Alt + Drag anchors on the canvas to match their position in space by estimation (by Clicking Alt while dragging). Note that this is a rough placement. After you press “Start RTLS” the Points will locate themselves accurately based on the distance measurements. See image E below.

  6. Moving Point (designated as “Desired” in the iOS device setup) appears as Full Circle with its color

  7. Click Start RTLS and wait a few seconds for the RTLS session to start.

  8. Example of working setup. See image F below.

Image D

Image D

Image E

Image E

Image F

Image F


Working with the Web Client

Below is a list of the controls of the web client:

Show ranges – will show the ranges measured between the Points.

You can load Jpg image as a background for the floor plan.

Zoom floor plan – scaling the background image of the map only.

Global zoom – scaling of the entire area.

Max speed – this parameter is an input to the location engine. Default is 50cm/sec that is good for walking person. The bigger the number is the location engine filters are “lighter” meaning enabling bigger distance over time changes. This parameter is taken as input only once at the start of the operation.


Get Pixie Point MAC address 

There is a way to see the MAC address of a Pixie Point from within the Pixie App. 

  1. Open the Pixie App.
  2. Go to Point Settings (swipe the Point icon to left).
  3. Double tap on the word "Connected".
  4. The MAC address will be shown above it for few seconds.