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.

BLE nodes V1

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:

  • A set of BLE nodes.
  • The Accuware Activation email with the credentials to access the Accuware dashboard.
  • At least 1 BLE beacon.

Step 1 – Configuration of the BLE nodes

Each one of the BLE nodes 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 Wi-Fi network (or multiple Wi-Fi networks) that covers ENTIRELY the area in which the BLE nodes will be installed. The BLE nodes don’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 nodes can be done using one of 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 Bluetooth 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 Bluetooth node.

Repeat the configuration for all the nodes starting from Step 8 and do not touch any other parameters! Leave the firmware upgrade OFF.

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 Bluetooth node that needs to be configured.
  5. A green led should start blinking every 5 seconds on the Bluetooth node.
  6. Inside the router settings look for the DHCP table (the list of devices connected to your WiFi router and the IP assigned to each one of them). TIP: sometimes this table is called “Attached devices“.
  7. Take note of the IP address assigned to the Bluetooth node (the MAC address of the Bluetooth node is the one printed on the bottom of the node).
  8. Open another browser tab and type the IP address assigned to your Bluetooth 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 Submit.
  18. Set MQTT broker to navimote2.navizon.com and click on Submit.
  19. Click on Restart Device.
  20. A green led should start blinking every 5 seconds on the Bluetooth node.

Repeat the configuration for all the nodes starting from Step 4 and do not touch any other parameters!!!

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 Bluetooth node.
  4. Inside the settings of your Android/iOS device look for the list of devices connected to your temporary WiFi network and take note of the IP address assigned to the Bluetooth node. If you don’t know how find the list of devices connected to your device please search on Google.
  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 (the tab 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 Bluetooth node to access the OVERVIEW).
  13. Click on SETUP.
  14. Set Request interval to 5 seconds and click on Submit.
  15. Set MQTT broker to navimote2.navizon.com and click on Submit.
  16. Click on Restart Device.
  17. A green led should continue blinking every 5 seconds on the Bluetooth node.

Repeat the configuration for all the nodes starting from Step 2 and do not touch any other parameters!!!

Aprilbrother_configuration_BT_nodes_iBeacons

Multiple permanent WiFi networks in a wide area: if the nodes are installed inside a wide area (covered by multiple permanent WiFi networks), then we strongly suggest to configure all your nodes to be able to connect to any of the permanent WiFi networks that covers the area. To do so you need to repeat the following steps for each one of the permanent WiFi networks that can be potentially used by the nodes.

  • Click on the PROFILES tab (it will be opened in a new window!).
  • Inside the SSID field type the SSID of the permanent WiFi network.
  • Chose the correct Security Type between Open/WEP/WPA1/WPA2.
  • Inside the Security Key field type the password of the permanent WiFi network.
  • Inside the field Profile Priority type 0.
  • Click on Add.

Step 2 – Physical installation of the nodes

During the physical installation of the nodes:

  1. print the floor plan uploaded inside the Accuware dashboard
  2. write on the floor plan the location and the MAC address of each one of the nodes that you want to install. The MAC address is printed on a label on the bottom of each node
  3. install the nodes in the environment keeping into account the information contained inside this support page.

Aprilbrother - BTLE iBeacons receiver

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.

Did you choose a reference system? To simplify the tracking of Bluetooth beacons and achieve the best results with Bluetooth Beacon Tracker, you MUST choose a reference system that will help you to accurately position the nodes. In fact, the locations, of the Bluetooth beacons, returned by the Accuware Bluetooth Beacon Tracker engine are based on the relative distances between the nodes and this is why a reference system is absolutely necessary in order to place the nodes inside the Accuware dashboard in correspondence of their real positions.

How to choose a reference system >>

Add the nodes

You will have to position each node on the floor plan. To set the nodes positions, 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.
  5. Repeat the Step 3 and 4 for all the nodes that have been physically installed in your site.

The node positions, set using the Accuware dashboard, are used to resolve the location of the mobile devices and this is why it is mandatory to closely match the nodes’ map locations with their physical locations. A small error during the placement of the nodes is acceptable (e.g. position on the dashboard at 0.5 meters from the real position).

Verify the reporting status

Once the Bluetooth nodes have been added to the Accuware dashboard to check the status of the nodes:

  1. Click on the BT Beacon Tracker > Map.
  2. Turn on a BLE beacon!
  3. Verify that all the nodes are active (green). The green color indicates that the nodes are 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.