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 Bluetooth Beacon Tracker API that we provide in order to integrate the indoor location capabilities, inside your web or mobile applications. The Accuware dashboard allows to manage and monitor the resources associated with a site, without having to call the Accuware 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
General > Geo-Fences

BT Beacon Tracker > Map
BT Beacon Tracker > Nodes
BT Beacon Tracker > Devices
BT Beacon Tracker > Settings
BT Beacon Tracker > Analytics
BT Beacon Tracker > Heatmap

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 (e.g. FREE EVALUATION or PRODUCTION).
  • Address: this coordinates allows 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 nodes (when available) and 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 sub-section enables you to manage the logical levels associated with a specific site. Use the levels mechanism to group BLE nodes based on:

  • their vertical positions (e.g. groups of nodes placed on different floors of the same store).
  • or their different locations (e.g. groups of nodes placed in 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.

To create a new logical level you need simply to:

  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 with a 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. Please keep in mind that even if it is possible to associate more than one floor plan for each one of the levels of a site, this practice is strongly discouraged.

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 with 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 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 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: 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 nodes (when available) and 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.

BT Beacon Tracker

Map

Accuware dashboard - Bluetooth Beacon Tracker - Map

This page is your main view to your Accuware Bluetooth Beacon Tracker installation:

Accuware Bluetooth Beacon Tracker maps: this section of the page shows for your current site

  • summary information about the total number of BLE nodes, the number of known BLE beacons detected in the past 5 minutes, the number of unknown BLE beaons detected in the 2 hours.
  • the position(s) of the node(s):
    • green icon indicates a properly working node.
    • red icon means that there is a problem and the node is not sending any report to the Accuware server from at least 35 seconds. If the problem persists, check here for solutions.
  • the location(s) of the station(s) detected by the nodes:
    • 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-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 BLE beacons 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 Bluetooth Beacon Tracker dashboard starting from the UUID, Major and Minor.
  • UUID, Major, Minor, Moving: the UUID, Major, and Minor parameters together make up your BLE beacons unique identifier and are the key components of all advertising packets continually transmitted by your BLE beacons. The Moving parameter is not used at present.
  • 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.

Nodes: this section of the page shows several information regarding the nodes registered within the site:

  • Name: an optional name associated to the node.
  • Description: an optional description associated to the node.
  • MAC: is the MAC address of the node.
  • Level ID: is the level on which the node has been added.
  • Last Report: is when the node sent its last report to the Accuware server.
  • Devices in Range: is the number of devices seen in the last report.
  • Status: a node is considered ACTIVE, if it has been able to transmit at least a report in the last 35 seconds.

Nodes

Accuware dashboard - Bluetooth Beacon Tracker - Nodes

This page allows the management of the nodes of your site:

Node Map: this section of the page shows all the nodes of a specific level of your site. It is possible to do the following actions:

  • Add a node: you can do so by following these simple steps:
    1. Choose the level on which you want to add the node(s) by using the drop-down menu in the top-left corner of the map.
    2. Activate the Floor Plan visualization by clicking the button in the top left  corner of the Map (this enable the highest level of zooming we strongly invite you to use it!).
    3. Click on the map to create a new node. The node positions, set using the Accuware dashboard, are used to resolve the location of the BLE beacons by the Accuware Bluetooth Beacon Tracker engine and this is why it is mandatory to closely match the nodes’ map locations with their physical locations.
    4. Insert the MAC address of the node(s) (MAC addresses must have this format AA:BB:CC:DD:EE:DD).
    5. (OPTIONALLY) insert a Name and a Description for the node(s).
  • Delete a node: you can do so by clicking on the node and clicking the Delete button.
  • Move the node: you can do so by dragging and dropping one or more nodes in a new location.

Nodes: shows the list of all nodes registered with the site. It is possible to Edit the information associated with a node (Name, Description, LevelID, Latitude and Longitude) or Delete a node by clicking the button on the right side of the table.

Devices

Accuware dashboard - Bluetooth Beacon Tracker - Devices

This page allows the management of all the stations (BLE beacons) detected by the nodes:

Known devices: this section of the page shows the list of all the known BLE beacons 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 of known devices you have two possibilities:

SCENARIO 1 – If you know the UUID, Major and Minor of the BLE beacon:

  1. Select the BT Beacon Tracker > Devices tab.
  2. Click on the Add Device button.
  3. Add the UUID, Major and Minor of the BLE beacon. A unique ID will be generated by the Accuware Bluetooth Beacon Tracker dashboard. This is your pMAC.
  4. (OPTIONAL) Add a Name and a Description to the BLE beacon.
  5. Press Save.

SCENARIO 2 – If you don’t know the UUID, Major and Minor of the BLE beacon:

  1. Select the BT Beacon Tracker > Devices tab.
  2. Scroll down until you see the Other devices table.
  3. You have now  two cases:
    1. CASE 1 – If there is only one BLE beacon in the Other devices table then that is your BLE beacon. The BLE beacon is identified by a unique ID generated by the Accuware Bluetooth Beacon Tracker dashboard. This is your pMAC.
      1. Click on the Edit button under the Action column.
      2. (OPTIONAL) Add a Name and a Description to the BLE beacon.
      3. Press Save.
    2. CASE 2 – If there is more than 1 BLE beacon in the Other devices table then you need to find out the BLE beacon of interest. You have 2 options:
      1. OPTION 1: 
        1. Install and open on your smartphone the App provided by the vendor of your BLE beacons.
        2. Activate the Bluetooth on your smartphone.
        3. Move the BLE beacon of interest next to the smartphone.
        4. Start the scanning of the BLE beacons around.
        5. Once you have the list of BLE beacons detected tap on the one closest to your smartphone and take note of the UUID, Major and Minor.
        6. Scroll up inside the Accuware dashboard and click on the Add device button under the Known devices table.
        7. Add the UUID, Major and Minor of the BLE beacon.
        8. (OPTIONAL) Add a Name and a Description to the BLE beacon.
        9. Press Save.
      2. OPTION 2:
        1. Move only the BLE beacon of interest next to one of the BLE nodes.
        2. Then click on BT Beacon Tracker > Map and select the All devices switch.
        3. Then next to the chosen BLE node there will be an ORANGE dot. Click on it and take note of the pMAC assigned to your BLE beacon.
        4. Select the BT Beacon Tracker > Devices tab.
        5. Scroll down until you see the Other devices table and search for the pMAC address assigned to your BLE beacon.
        6. Click on the Edit button under the Action column.
        7. (OPTIONAL) Add a Name and a Description to the BLE beacon.
        8. Press Save.

Other devices:  this section of the page shows the list of all the unknown BLE beacons detected in proximity of the site during the past 2 hours. It is possible to Add a BLE beacon among the list of Known devices clicking on the Edit button under the Action column.

Settings

Accuware dashboard - Bluetooth Beacon Tracker - Settings

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

  • Report Frequency:  (not relevant for Bluetooth Beacon Tracker)
  • Node Type: (not relevant for Bluetooth Beacon Tracker)
  • RssModel: (not relevant for Bluetooth Beacon Tracker)
  • 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.

Analytics

Accuware dashboard - WiFi Location Monitor - Analytics

  • If you see the error message “Error, this site is not enabled for Accuware Analytics. Please submit a support request using this form to activate Accuware Analytics” when trying to access the Analytics area of the Accuware dashboard, it could be for one of the following reasons:
    • The Analytics section of the Accuware dashboard is not active. Please keep in mind that it is not activated by default with an Accuware Bluetooth Beacon Tracker account. If you want to activate the Analytics section on your account please submit a support request using this form.
    • The Analytics section of the Accuware dashboard is active…but your nodes have never been seen active. You will be able to access the Analytics section of the Accuware dashboard only when there will be at least 1 node active (GREEN) inside Accuware dashboard (and inside the Cloudtrax dashboard).
  • If you just want to take a look at the Analytics section of the Accuware dashboard and the Analytics section is not yet active on for site, you can log-out from your site and log-in these credentials:
    • username: demo@accuware.com
    • password: LEAVE EMPTY
  • Keep in mind also that it takes some hours for the Accuware Analytics charts to show meaningful information.

The Analytics section of the Accuware dashboard allows to see and export the information related to 4 different metrics.

Map View:

  • green icon indicates a properly working node;
  • red icon signifies that the node lost connectivity to the server. If the problem persists, you can find a solution in this page.

Real-time Updates: summarizes the number of unique stations detected by all the nodes in their last reports. Every 3 seconds each node reports to the Accuware server the number of unique BLE devices detected and these reports are aggregated to show the count of the unique BLE devices seen by all the nodes of your site.

Site Statistics: shows the count of unique BLE devices seen since the beginning of the day, week and month.

Recent Visitors: shows the number of unique BLE devices seen in the last 6 hours or the number of reports received by the Accuware server in the last 6 hours. Data is aggregated at 10 minutes intervals. The data point shown at time “t” is related to the data collected by during the time window “t-10 minutes” to “t”.

  • EXAMPLE: if you walk by 3 times, say between 10:00:01 AM and 10:09:59 AM, it counts you as one. If you walk by again at 10:10:00 AM it will count you another time. If your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes.

Historical Data: displays counts for a specific time period (From-To) and a specific granularity (Freq). By default you will see the unique BLE devices seen by all the nodes of your site during the past 7 days.

  • Settings: if your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes. Under the Settings menu you can also choose between 4 different metrics:
    • Unique Visitors (unmc): counts the number of unique BLE devices. Again, if you select Freq “Hourly”, it will count you as one if you walk by any time between 10:00:00 AM and 10:59:59 AM, and then it will count you again if you walk by any time after 11:00:00 AM.
    • Report Count (repc): counts the number of “reports” transmitted by nodes. When working properly, the nodes send 1 report every 3 seconds (a total 1200 reports/hour). If there are problems with the Internet connection and the repc is lower than 1200 reports/hour, then you might see a drop in the number of Unique Visitors (unmc) simply because the node is not able to transmit the reports to the Accuware server.
    • In Place Visitors (idh3): represents for each hour, the number of BLE devices seen, at least once, during the previous 3 hours and it is used to see the “stationary visitors”. This means that if a MAC address is detected (at least once) between [7:00:00 AM-07:59:59 AM], between [8:00:00 AM-08:59:59 AM] and between [9:00:00 AM-09:59:59 AM], then at 10:00:00 AM, the MAC address is counted as a “In place visitor”. IMPORTANT: Obviously, the graph can be seen only with the “Hourly” frequency filter is selected.
    • Unique daily devices by hour (undh) : represents for each hour, the number of new  BLE devices seen during the previous hour. By new we mean never detected so far since the beginning of the day. This means that if a  BLE device is seen multiple time during a day it will be counted only once. IMPORTANT: Obviously, the graph can be seen only with the “Hourly” frequency filter is selected.
  • Export (.csv): you can also export CSV files which contain the following fields for each row:
    • the time stamp
    • one or more of these metrics:
      1. Unique Visitors (unmc)
      2. Report Count (repc)
      3. In Place Visitors (idh3)
      4. Unique daily devices by hour (undh)

Before exporting the CSV file, you have to:

  1. Choose the metric(s) of interest by clicking the Settings button.
  2. Filter on the time window (From-To).
  3. Filter on the frequency (Freq).
  4. Click on Export (.csv) button.

The gear button in the top right corner of the page (under the siteID) allows you to change the Node sensitivity. This parameter allows you to set the sensitivity of all the nodes. This means that Analytics will count only the BLE devices with an RSS higher (or equal to) the chosen threshold. Moving the slider to the left reduces the threshold/detection radius (thus reducing the number of Wi-Fi devices counted). Please keep in mind that it is not possible to set different RSS thresholds for different nodes.

RSS vs distance: even if it is true that the RSS value, for a BLE device, decreases as the distance from the node increases. It is also true that the RSS value does not decrease linearly and it is also affected by different materials in the environment. For these reasons we suggest to perform some empirical tests to determine how the RSS varies with the distance from the nodes (the spots) in your specific environment. These kind of empirical tests can be performed following the instructions in this support page.

Heatmap

Accuware dashboard - Heatmaps

A heat map is a graphical representation of data where values in a matrix are represented as colors. A simple heat map provides a compact, visual summary of quantitative information. Some elaborate heat maps enable viewers to visualize complex data sets. Location-related data is usually overlaid on a floor plan.

The Heatmap section of the Accuware dashboard is a demonstration tool that allows to see the density, over time, of the devices detected by Accuware Accuware Bluetooth Beacon Tracker. Location-related data is usually overlaid on the floor plan uploaded.

Please be aware that:

  • the Accuware heat maps dashboard is not activated by default with a Accuware Bluetooth Beacon Tracker account. The heat maps dashboard is activated upon explicit request
  • the Accuware heat maps dashboard can be used ONLY in conjunction with:
  • The Accuware heat maps dashboard may be subject to changes and interruptions due to system maintenance and upgrades.
  • If you just want to take a look at the Heatmap section of the Accuware dashboard and the Heatmap section is not yet active on your site, you can logout from your site and loging these credentials:
    • username: demo@accuware.com
    • password: Accuware2018
    • SiteID: 1001

Notifications of possible interruptions in case of updates are provided well in advance.

How to visualize a heatmap

  1. Select the desired floor plan using the pull-down menu in the top-right corner of the large map. The floor plan will appear superimposed on the map
  2. Under Synchronization:
    1. Check if the Timezone detected by the system is the correct timezone. If not, please change the timezone using the drop-down menu.
    2. Fill the Sync data up to field with the number of previous days that you want to use in your analysis.
    3. Click on Synchronize now to retrieve the data from the server. After the synchronization is complete, a density map will appear over the floor plan.
  3. You can use the controls in the Display section to manage the data set. You can:
    • view data for a specific day using the Select day pull-down menu.
    • select the size (in terms of number of hours) of data to be displayed for each day. It is possible to see the aggregated data for a 24-hours period, or just data for a 10-minutes window.

How to build your custom heat maps dashboard

You can easily create similar heat maps using the data provided by: