Please be aware that the Accuware dashboard is a powerful administration tool based on Javascript, CSS and HTML that uses exactly the same set of Accuware Wearabouts API that we provide in order to integrate the indoor location capabilities, inside your applications. The Accuware dashboard allows to manage and monitor the resources associated with a site, without having to call the Accuware Wearabouts API. It is not a product that Accuware sells or customizes (even if we are open to suggestions to make it even more powerful).

Login

General > Sites
General > Levels
General > Floor plans
General > Accounts

Wearabouts > Map
Wearabouts > Devices
Wearabouts > Fingerprinting
Wearabouts > VPS Fingerprinting
Wearabouts > History
Wearabouts > Settings
Wearabouts > Configuration

Login

Access the Accuware dashboard at at this link and follow the instructions on the login screen. Please supply the credentials contained in the email from Accuware Activation email and press the Login to Dashboard button.

General

Sites

Accuware dashboard - General - Sites

Once authenticated you will be automatically redirected under the Sites sub-section of the General section where you will find the following areas:

Current Site: summarizes and lets you change basic information of the site.

  • Site ID: your unique site identification.
  • Name: your custom site name.
  • Description: the expiration date of your site along with the type of account (FREE EVALUATION or PRODUCTION).
  • Access: this is the access level associated with your account (more information about the meaning of the value in the next paragraphs).
  • Address: this coordinates allows to place the Map on the area of interest.

Available Sites: summarizes your list of sites (along with some basic information) and lets you switch from one site to another by clicking the Select button on the right side of the table.

Levels

Accuware dashboard - General - Levels

This sub-section enables you to manage the logical levels associated with a specific site. Use the levels mechanism to group floor plans based on:

  • their vertical positions (e.g. different floors of the same store).
  • or their different locations (e.g. different stores of the same shopping mall).

PLEASE READ:

  • For each Site you will find the default level with LevelID 0. This level can not be eliminated.
  • Using the Accuware dashboard it is possible to create 30 Levels (in addition to Level 0). Additional levels can be created using this PUT API call.

You can create more levels (and later, add one and only one floor plan to each level) by following these steps:

  1. Click on the Add Level button.
  2. Select a LevelID for the new level.
  3. (OPTIONAL) insert a Name and a Description.
  4. Click on Save.

You can also Edit the information associated to each level or Delete a level by using the buttons on the right side of the table.

Floor Plans

Accuware dashboard - General - Floorplans

This sub-section enables the management of the floor plan(s) associated with each logical level of a site. Even if it is practically possible to associate more than one floor plan for each level we strongly encourage you to upload ONLY one floor plan for each Level.

To upload a new floor plan you need simply to read the step by step guide at this link.

You can also View a floor plan, Edit the information associated to a floor plan or Delete a floor plan by using the buttons on the right side of the table.

Accounts

Accuware dashboard - General - Accounts

This section enables the management of the users who are allowed to access to the Accuware dashboard (and allowed to call the Accuware Wearabouts API):

Your account: allows the assignment of a new password for the user account currently logged in.

Registered Accounts: gives a list of users currently registered in the site and allows to Change the Access level of a specific account (see below) or to Delete a specific account.

To create a new account you need simply to:

  1. Click on the Add Account button
  2. Insert the email address of the new user
  3. Select the Access level for the new user (see below)
  4. Click on Save

Please be aware that the initial password for new users will be EMPTY and new users will be able to change their password under the General > Accounts section after the first login.

Access levels: Accuware accounts have 3 access levels for each account registered with a site. Users with Read-Only access (access = 10) are not allowed to make changes to the site, while users with Read-Write access (access = 20) can modify data regarding the Wearabouts devices. Full control access (access = 30) is required to create and delete user accounts within a specific site.

Wearabouts

Map

Accuware dashboard - Wearabouts - Map

This page is your main view to your Wearabouts installation.

Wearabouts map: this section of the page shows your current site:

  • the location(s) of all device(s) that are making use of the Wearabouts engine:
    • YELLOW dots: devices active in the past 15 minutes.
    • GREY dots: devices that were active more than 15 minutes ago. By clicking on the dots you will be able to see the last time a device has been seen and additional information.
  • In the top-right corner of the map there are:
    • a button to enlarge the Map to full screen.
    • a drop-down menu that allows to select the level of the site to be shown.

Devices: this section of the page shows the list of all the devices registered within the site along with the following information:

  • Name – the optional name assigned under the Wearabouts > Devices section.
  • Desc – the optional description assigned under the Wearabouts > Devices section.
  • Mac – the device unique ID:
    • Wearabouts App for Android: the pseudo MAC address is assigned by the Wearabouts App running on the device and contains a total of 12 characters beginning with a “W”.
    • Wearabouts App for iOS: the pseudo MAC address is assigned by the Wearabouts App running on the device and contains a total of 12 characters beginning with a “X”.
    • Accuware Smart Tags: the MAC address is printed on a label on the back of the Accuware Smart Tag and begins with 54FB58
  • Level ID – the level on which the device is located.
  • Position – the location computed by the Accuware server. It is possible to center the map to the location of the device by clicking on the Go To Location button (the blue icon near the coordinates). If the dashboard show a valid battery level, e.g. 50%, but unknown position (“N/A”) this means the device is able to communicate with the server, but the data sent by the device can’t lead to valid location.
  • Source – the source of the location:
    • Indoors – this location is computed by using the Accuware database of fingerprints of Wi-Fi and/or Bluetooth signals available if an indoor fingerprinting has been performed.
    • Global – this location is computed by using the Navizon global database of Wi-Fi and cellular tower signals throughout the world. The location can be computed using the most recent cellular tower reading only when the device screen is unlocked or it is running on a charger. When the screen is locked or the device is not running on a charger the cellular tower readings are not reliable.
    • Core (not relevant to the Smart Tags) – this location is provided by the Android or iOS location manager after having set the Core location parameter to On. When the Core location parameter is set to On the Wearabouts App will not obtain a GPS fix by itself but it will use the GPS coordinates from a GPS satellite fix obtained through a 3rd party app active on your device (e.g. Google Maps). This can increase the battery consumption. It must be kept in mind that the accuracy of the Core location is not under the responsibility of Accuware.
    • Camera (not relevant to the Smart Tags and to Wearabouts for iOS) – this location is computed by using the Accuware database of fingerprints of images available if an indoor fingerprinting has been performed.
  • Battery – the battery level detected along with a label for the charging status.
  • Last Seen – shows when the device has been seen last time by at least one of the nodes. N/A means that the device has never been seen active or has not been seen active since the last upgrade of the Accuware dashboard.
  • ACTION – this column contains 4 buttons:
    • Radius of confidence: this button can be used to visualize the radius of confidence.
    • Follow on the map: this button can be used to center the location on a specific device and follow its movements on the map.
    • Push notification: this button can be used to force a location update. A sound is emitted by the device. Not available for the Smart Tags.
    • Push silent notification: this button can be used to force a location update. No sound is emitted by the device. Not available for the Smart Tags.

Which location source is shown? If a source of location has a time-stamp at least 15 seconds greater than the time-stamps of the other 2 sources of location, then that source of location is chosen. If there are 2 sources of location with 2 time-stamps that do not differ more than 15 seconds, then the source with the higher accuracy (smaller radius of confidence) is chosen by the Wearabouts engine.

Devices

Accuware dashboard - Wearabouts - Devices

Registered devices: this section of the page shows the list of all the devices registered within the site. By using the buttons on the right side of the table it’s possible to edit the information associated with a device (Name, Description), delete a specific device, or configure a specific device (device-specific settings).

To add a device to your site you need to:

  1. Click on the Add Device button.
  2. Insert the ID of the device. The ID is written on the screen of your device when you activate the Wearabouts App and contains a total of 12 characters beginning with a “W” for Android devices and with a “X” for iOS devices, or the MAC address that is shown on the back of the Smart Tag that starts with 54FB58 and contains a total of 12 characters.
  3. (OPTIONAL) insert a Name and a Description.
  4. Click on the Save button. If you get the Error message “MAC ‘WXXXXXXXXX’ is already associated with another site, you need to remove the ID of that device from an already existing site. At present, devices can not be associated to multiple sites.

Site-wide VS device-specific settings: please keep in mind that all the devices inherit the site-wide settings unless they are configured with device-specific settings.

To configure the parameters for a specific device (device-specific settings) click on the Config icon with a gear located inside the Action column.

This is what will be possible to do in this section:

  • Associated: the amount of time passed since the device has been registered.
  • Configured: the amount of time passed since a configuration has been sent to the device.
  • Show config for: show the type of device automatically detected. It can’t be changed.
  • For all the info about the parameters see the section Parameters paragraph below.
  • Controls: you can Inspect (view) the JSON with the parameters, Save the parameters, Reset the parameters ​to the site-wide parameters (which can be different from the the defaults).

Parameters description: a complete description about the parameters that can be configured at site level (site-wide parameters) or at device level (device-specific parameters) can be found inside the pages:

Fingerprinting

Indoors Fingerprinting: inside this section of the page you can find:

  • two buttons used to enlarge the map and to refresh the map content.
  • a set of tools (from left to right):
    • Display Mode: choose whether to visualize the fingerprints as dots or as routes.
      • if fingerprints is selected then a new button appears: Tolerance. Because displaying a huge number of markers on the map can be bad for the performance, the fingerprints are clustered to reduce this number. A tolerance set to “0” means ALL the markers are displayed (no clustering). A tolerance set to “30” means, only a few markers will be displayed. This tolerance is also calculated and changed every time the user zoom in or zoom out.
      • if routes is selected then a new button appears: Line Width. Just change the line width for each lines displayed on the map.
    • Hand selection: Used to select one route or one fingerprint (depending on the current display mode). Can be combined with CTRL key to select or deselect multiple objects.
    • Shapes selection (circle, polygon, rectangle): Draw directly the shapes on the map to select multiples routes or fingerprints.
    • Clear: deselect all the routes or fingerprints selected.
    • Delete: delete the selected routes or fingerprints. This action is not reversible!
    • Delete all: delete all the routes or fingerprints. This action is not reversible!
    • Level selector: shows the list of levels available in your site. For each level you will find:
      • the Level ID.
      • the Level name.
      • the total number of fingerprints collected through the level.
  • the Google Maps view with the floor plan for the chosen level (when available). On the floor plan you can find the fingerprints collected in the form of an heat-map where:
    • Warm dots represent a location in which the highest RSS detected is very high (close to 0 dBm)
    • Cold dots represent a location in which the highest RSS detected is very low (close to -110 dBm)

Loading time: if you have a large number of fingerprints, the visualization of all the fingerprints can take a while.

When hovering with the mouse on a fingerprint on the map, it is possible to see the actual RSS value (in dBm) of the radio signal source that has been seen with the highest RSS. When looking at the fingerprints please be aware that it is completely normal to see colder colors for the fingerprints related to the iBeacons because their transmission power is lower.

Devices: inside this section of the page you can find a big table with important information regarding the radio signals detected during the fingerprinting process. It is possible to sort the table information by column to get very interesting insights that can be used to evaluate the quality of the fingerprinting.

For each one of the radio signal sources detected during the fingerprinting phase, it is possible to see:

  • MAC: a unique identifier for the Wi-Fi access points and/or iBeacons. The unique identifier of the iBeacons starts with the letter “I”
  • Mfr: the manufacturer of the Wi-Fi access points (when available)
  • Max (dBm): the maximum RSS detected for the signal source.
  • Min (dBm): the minimum RSS detected for the signal source.
  • Delta (dBm): the difference between Max and Min RSS values. An high delta is always positive because it means that the radio signal will be detected with a wide range of RSS values (from Min to Max) during the positioning process, giving a positive contribution to the locating algorithm.
  • Points: the number of times a radio signal source has been detected during the fingerprinting phase. An high number of points is always positive because it means that the radio signal will be seen very often during the positioning process, giving a valuable contribution to the location algorithm.
  • Show: this is a check box used to show all the locations in which the selected radio signal has been detected in the form of an heat-map where:
    • Warm dots represents a location in which the radio signal has been seen with a high RSS.
    • Cold dots represents a location in which the radio signal has been seen with a low RSS.
    • Empty dot represents a location in which the radio signal has not been detected.

In the last line of the table (left corner) it is possible to see the total number of different radio signal sources detected by the Accuware Indoors App during the fingerprinting of the chosen level.

Devices used for fingerprinting: this section contains a list of all the devices used to collect the fingerprints for the specific level selected. For each device listed it is possible to see:

  • the MAC address:
    • the ID of iOS devices begin with the letter “U”
    • the ID of Android devices can be the real MAC address or it can be an ID that starts with the letter “N”
  • the manufacturer info (when available).
  • the total number of fingerprints collected.


VPS Fingerprinting

Soon available

History

Accuware dashboard - Wearabouts - History

Inside this section of the Accuware dashboard you can view the historical locations of your Wearabouts devices on a specific day. Please keep in mind that the historical locations:

  • are the exact same locations shown live under Wearabouts > Map and available through the Wearabouts “devices” API.
  • are displayed as a spaghetti diagram, meaning that two consecutive locations will be connected with straight line.

In order to activate the collection of the historical locations you need to read and accept the terms of agreement by switching the button and then click on ENABLE HISTORY.

To view the historical spaghetti diagram of a specific device:

  1. Select the specific date of interest using the calendar. Please remember that:
    • Green dates: with available data.
    • Red dates: with no data.
    • Data for day X are not available before 00:01 UTC of day X+1.
  2. Select the timezone, if the one shown is not the correct one.
  3. Select the desired level using the pull-down menu in the top-right corner of the large map. The floor plan will appear superimposed on the map
  4. Click on the floor plan button in the top-left corner of the large map.
  5. Click on the Go to Location button next to the device you are interested in.
  6. Zoom in as much as possible using mouse wheel or the buttons in the bottom-right corner of the map.
  7. Enable the Show switch the device you are interested in (you can enable the Show button for multiple devices and each device will be represented with a different color according to the color of the Show button).
  8. Choose the start time and the end time you are interested in moving the left and right sliders respectively.
  9. Click on Play to view the animation of the spaghetti diagram.
  10. (OPTIONALLY) Enable the Heatmap switch.

On the upper right side there is a gear to access the settings of the page. You can use this area to:

  • Enable/disable the Logging.
  • Delete al the data collected so far.

How to create the same spaghetti diagram inside your dashboard

Settings

Accuware dashboard - Wearabouts - Settings

This page allows the management of the advanced settings of the site:

  • Noise Reduction: enables a filter that will remove some of the noise present in the measurements. The filter should be able to make the locations less “jumpy”, although it might introduce some latency in the locations updates. The best advice is to try different settings and see if any of them improves the locations. It will take up to 1 minute before this setting becomes active.

Configuration

This section allows the management of the parameters at site level (site-wide settings). “At site level” means that the parameters will be assigned by default:

  • to all the new devices.
  • and to all the devices that don’t have device-specific settings.

Here is what is shown in this page:

  • Last update: the amount of time passed since the site-wide parameters have been saved.
  • Show config for: a top-down menu that allows to show the parameters for a specific type of device (Android devices/iOS devices/Smart Tags)
  • For all the info about the parameters see the section Parameters below.
  • Controls: you can Inspect (view) the JSON with the parameters, Save the parameters, Reset the parameters to their default.

Parameters description: a complete description about the parameters that can be configured at site level (site-wide parameters) or at device level (device-specific parameters) can be found inside inside the pages: