PLEASE READ: If you need information about:

  • BLE nodes (V2) without external antennas and WiFi interface please refer to this page.
  • BLE nodes (V3) with external antennas, Ethernet interface and WiFi interface please refer to this page.

WARNING: before proceeding with single node installation of Accuware Bluetooth Beacon Tracker, please be aware that using 1 node, Accuware Bluetooth Beacon Tracker will not be able to trilaterate the positions of the BLE beacons detected. This means that the locations (latitude and longitude) of all the BLE beacons detected will be equal/identical to the location of the unique node installed (when looking at the Accuware dashboard and when calling the Accuware Bluetooth Beacon Tracker “stations” API).

Despite this, even with only 1 node, you will be able to test the Accuware Bluetooth Beacon Tracker API and make assertions regarding the proximity of the BLE beacons detected with respect to the node by using the RSS values returned by the Accuware Bluetooth Beacon Tracker API. Please look at this article for more details.

Prerequisites

Before installing Bluetooth Beacon Tracker make sure you have read carefully all the pages (prior to this page) that can be found on the left sidebar and make sure you have:

  • 1 node.
  • The Accuware Activation email with the credentials to access the Accuware dashboard.
  • At least 1 BLE beacon.

Step 1 – Configuration of the node

The BLE node must be configured properly to communicate with the Accuware server. These are the things that need to be configured by following one of the methods described in the next paragraphs:

  • the permanent WiFi network that will be used to communicate with the Accuware server. The permanent WiFi network is a network that covers ENTIRELY the area in which the BLE node will be installed. The BLE node does’t have an Ethernet interface. If the permanent WiFi network is behind a firewall, then you have to check that:
    • the following ports are open on your firewall: 53/tcp (DNS), 80/tcp (HTTP), 443/tcp (HTTPS), 1883 and 8883.
    • the following domains are accessible: its.accuware.com and navimote2.navizon.com.
  • the endpoint of the Accuware MQTT broker/client.
  • the transmission frequency (aka the Request interval).

The configuration of the BLE node can be done using the following methods (in order of preference)

1.1 – Using an App for Android/iOS

  1. Install the SimpleLink™ Wi-Fi® Starter App on your device by clicking on one of the links below from the Android/iOS device:
  2. Enable the WiFi on your device.
  3. Connect your device to the permanent WiFi network.
  4. Enable the Bluetooth on your device.
  5. Start the App.
  6. The SSID of the permanent WiFi network should be displayed automatically inside the Network Name field of the App.
  7. Enter the password of the permanent WiFi network.
  8. Turn ON the first node that you want to configure and wait 5 second.
  9. Click on the START button inside the App. The scanning can take a while.
  10. After few seconds the App should show the message “New Device Found!“. Click on OK. If you see the message “No New Device Found!” click on Nothing and click again on START.
  11. A green led should start blinking every 5 seconds on the BLE node.
  12. Click on the Devices button inside the App.
  13. Click on the device under the Recently Added area. Once done the OVERVIEW tab will be opened inside a browser window.
  14. Go back to the OVERVIEW tab.
  15. Click on SETUP.
  16. Set Request interval to 5 seconds and click on Submit.
  17. Click on SETUP.
  18. Set MQTT broker to navimote2.navizon.com and click on Submit.
  19. Click on SETUP.
  20. Click on Restart Device.
  21. A green led should continue blinking every 5 seconds on the BLE node.

Do not touch any other parameter! DO NOT upgrade the firmware on the BLE node.

Aprilbrother_configuration_BT_nodes_iBeacons

1.2 – Using your WiFi router

  1. Set a WiFi router to broadcast a temporary WiFi network with the following parameters:
    • SSID: hello
    • Password: 12345678
  2. Connect your PC/laptop to this temporary WiFi network.
  3. Open your browser and type the address of the WiFi router. TIP: on Windows the address is the one shown under the “Default Gateway” when the command “ipconfig” is typed inside a Windows shell.
  4. Turn ON the first BLE node that needs to be configured.
  5. A green led should start blinking every 5 seconds on the BLE node.
  6. Inside the router settings, look for the DHCP table (the list of devices connected to your WiFi router [identified by their MAC addresses] and the IP assigned to each one of them). TIP: sometime this table is called “Attached devices”.
  7. Take not of the IP address assigned to the BLE node (the MAC address of the BLE node is the one printed on the bottom of the node).
  8. Open another browser tab and type the IP address assigned to your BLE node to access the OVERVIEW tab.
  9. Click on the PROFILES tab (it will be opened in a new window!).
  10. Inside the SSID field type the SSID of the permanent WiFi network.
  11. Chose the correct Security Type between Open/WEP/WPA1/WPA2.
  12. Inside the Security Key field type the password of the permanent WiFi network.
  13. Inside the field Profile Priority type 0.
  14. Click on Add.
  15. Go back to the OVERVIEW tab.
  16. Click on SETUP.
  17. Set Request interval to 5 seconds and click on Save.
  18. Set MQTT broker to navimote2.navizon.com and click on Save.
  19. Click on Restart Device.
  20. A green led should start blinking every 5 seconds on the BLE node.

Do not touch any other parameter! DO NOT upgrade the firmware on the BLE node.

Aprilbrother_configuration_BT_nodes_iBeacons

1.3 – Using your Android/iOS device as a WiFi hotspot

  1. Set your Android/iOS device to broadcast a temporary WiFi network with the following parameters
    • SSID: hello
    • Password: 12345678
  2. Turn ON the first node that needs to be configured.
  3. A green led should start blinking every 5 seconds on the BLE node.
  4. Look for the BLE node inside the list of devices connected to your temporary WiFi network and take note of the IP address assigned to the BLE node.
  5. Open the browser on your Android/iOS device  and type the IP address assigned to your BLE node to access the OVERVIEW tab.
  6. Click on the PROFILES tab (it will be opened in a new window!).
  7. Inside the SSID field type the SSID of the permanent WiFi network.
  8. Chose the correct Security Type between Open/WEP/WPA1/WPA2.
  9. Inside the Security Key field type the password of the permanent WiFi network.
  10. Inside the field Profile Priority type 0.
  11. Click on Add.
  12. Search for the OVERVIEW tab (or type the IP address assigned to your BLE node to access the OVERVIEW).
  13. Click on SETUP.
  14. Set Request interval to 5 seconds and click on Save.
  15. Set MQTT broker to navimote2.navizon.com and click on Save.
  16. Click on Restart Device.
  17. A green led should continue blinking every 5 seconds on the BLE node.

Do not touch any other parameter! DO NOT upgrade the firmware on the BLE node.

Aprilbrother_configuration_BT_nodes_iBeacons

Step 2 – Physical installation of the node

The Bluetooth Beacon Tracker leverages a set of nodes that need to be deployed in the area to monitor. The nodes are programmed to detect Bluetooth signals transmitted by nearby BLE beacons and report this information to the Accuware server. To ensure proper communication with the Accuware server, all the nodes need to have electricity and need to be connected to the Internet using the permanent WiFi network set at the previous step. One of the strengths of our Bluetooth Beacon Tracker is that there is no need to deploy Ethernet cables all around the building that you want to monitor!

During the installation of the node take note of the MAC address and its location. The MAC address is printed on a label on the bottom of each node. The node MUST be placed following carefully the information contained inside this support page.

Step 3 – Configuring the Accuware dashboard

Login to the Accuware dashboard

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

Add the node

To set the node position, please:

  1. Select BT Beacon Tracker > Nodes
  2. Enable your floor plan by clicking on the Floor plan button in the top left corner of the map (it might take a few seconds to see the floor plan if the image is large).
  3. zoom on the floor plan as much as possible and click on the map to create a new node (or click on marker to edit the information of an existing node). Enter its MAC address and optionally a name and a description that will make it easier to identify the node itself.
  4. Click on Save. If you see an Error message it means that the node is inside another Accuware site. Please submit a support request using this form and provide us the MAC address so we can remove it from the other site.

Verify the reporting status

Once the BLE node has been added to the Accuware dashboard to check the status of the node:

  1. Click on the BT Beacon Tracker > Map.
  2. Turn on a BLE beacon!
  3. Verify that the node is active (green). The green color indicates that the node is reporting data to the Accuware server.

IMPORTANT: please be aware that:

  • BLE nodes ​running a firmware equal or lower than 0.10 ​ will be shown RED inside the Accuware dashboard if no BLE beacons ​will be in range​. As soon as a BLE beacon will be in range the BLE nodes will be shown GREEN inside the Accuware dashboard.
  • BLE nodes running a firmware greater than 0.10 will be shown GREEN inside the Accuware dashboard even if no BLE beacons will be in range.
You can upgrade the firmware of your BLE nodes from the SETUP page of the node following these steps:
  1. Select “On – Auto update the firmware“.
  2. Click on Submit and wait for the page to refresh
  3. Click on Restart device.

Test Bluetooth Beacon Tracker

You can now test the tracking capabilities of Bluetooth Beacon Tracker by following the instructions inside this support page.