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 Indoor API that we provide in order to integrate the resources inside your applications. The advantage of the Accuware dashboard is that it allows to manage and monitor the resources associated with a site, without having to issue API calls. Anyway the Accuware dashboard is not a product that we sell or customize (even if we are open to suggestions to make it even more powerful).

Login

General > Sites
General > Levels
General > Floor plans
General > Accounts
General > Geo-Fences

Indoors Tracking > Map
Indoors Tracking > Devices
Indoors Tracking > Settings
Indoors Tracking > Fingerprinting

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).
  • Address: these coordinates allow to place the map on the area of interest.
  • Access: this is the access level associated with your account (identified by your email address).

Access level: 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 stations. Full control access (access = 30) is required to create and delete user accounts within a specific site.

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 section enables to manage the levels associated with a specific site. The levels should be used to divide the floor plans based on:

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

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

  1. Select General > Levels.
  2. Click on the Add Level button.
  3. Select the Level ID and assign a Name and a Description (optional).
  4. Click on Save.

Using the Accuware dashboard it is possible to create up to 30 Levels (in addition to the Level 0). Additional levels can be created using this PUT API call.

It is also possible to Edit the information associated with a level or Delete levels by using the buttons on the right side of the table.

Floor Plans

Accuware dashboard - General - Floorplans

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

It is also possible to View a floor plan, Edit the information associated with a floor plan or Delete a floor plan and Copy 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 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:

  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 the new user will be EMPTY and the new user will be able to change his/her password under the Accounts section after the first login.

Access levels: the Accuware accounts have 3 types of 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 station. Full control access (access = 30) is required to create and delete user accounts within a specific site.

Geo-fences

Accuware dashboard - General - Geo-fences

This section enables the management of the geo-fences associated to the levels of your site. Geo-fences are virtual polygons (made of multiple vertex) used in order to divide a floor plan into multiple areas allowing afterwards to identify the sub area in which each one of the devices is located:

  • looking at the Geo-fence column of the Map section of the Accuware dashboard.
  • or looking at the areas field of the JSON returned by the station API call.

To create a geo-fence:

  1. Select the level of interest using the drop-down menu in the top-right corner of the map.
  2. Leave the top-left button to INCLUDE.
  3. Click on the button with the star and click on the map to define the first vertex of the geo-fence.
  4. Click on the map to define the geo-fence (each geo-fence can contain an unlimited number of vertex). At the end click on the first vertex to close the geo-fence. The geo-fence has been created and an ID has been assigned to it.

To modify a geo-fence:

  1. Click on the geo-fence area.
  2. Modify the geo-fence vertex.
  3. Click outside the geo-fence area.

In order to delete a geo-fence:

  1. Click inside the geo-fence area.
  2. Click on the Trash button.

Indoors Tracking

Map

Accuware dashboard - Indoors - Map

This page is your main view to your Indoors Tracking installation.

Indoors maps: this section of the page shows your current site

  • summary information about the total number of known devices detected in the past 5 minutes.
  • the location(s) of the station(s) registered within the site:
    • ORANGE dots: unknown stations active in the past 10 minutes.
    • YELLOW dots: known (registered) stations active in the past 5 minutes.
    • GREY dots: known (registered) stations active in the past 60 days (but not seen anymore from more than 5 minutes). By clicking on the dots you will be able to see the last time a device has been seen in the site.
  • Below the map it is possible to find a set of tools useful to filter the information shown on the map.
  • In the top-left 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:

  • Name: an optional name associated to the device.
  • Description: an optional description associated to the device.
  • MAC: is the pMAC address of the device. The pseudo MAC address is a unique ID generated by the Accuware Indoor Tracking engine:
    • Indoors Tracking for Android: the pMAC address can be found under the Settings of the Accuware Indoors App or it can be retrieved calling a function of the Accuware Indoor SDK. It contains a total of 12 characters beginning with a “N” (e.g. N4K2A58VSIF4)
    • Indoors Tracking for iOS: the pMAC address can be found under the Settings of the Accuware Indoors App or it can be retrieved calling a function of the Accuware Indoor SDK. It contains a total of 12 characters beginning with a “U” (e.g. U6K2AI8VSIF4)
  • Level ID: is the level on which the device has been added.
  • Mfr/Type: if the manufacturer of the device (if available). This information is added at run time by Javascript embedded inside the dashboard.
  • 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.
  • Geo Fences: shows the IDs of the geo-fences in which the device is currently located.
  • Show button: enable the visualization of a specific BLE beacons. It must be used in conjunction with the Selected button bellow the Map.

Devices

Accuware dashboard - Indoors - Devices

This page allows the management of all the stations.

Known devices: this section of the page shows the list of all the known devices registered within the site. It is possible to Edit the information associated with a Known device (Name, Description) or Delete a specific Known Device by using the buttons on the right side of the table.

To add a Known device inside the list you need simply to:

  1. Click on the Add Device button.
  2. Insert a the pMac address of the device that can be found inside the MISCELLANEOUS section of the Accuware Indoors App (for Android and iOS)
  3. (OPTIONAL) insert a Name and a Description.

Settings

Accuware dashboard - Indoors - Settings

This page allows the management of 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. Again, 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.

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