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 endpoint, port and topic 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 a desktop application for Windows/Ubuntu
- Turn on the BLE node that you want to configure and connect it to a network using an Ethernet cable.
- Install the configuration application on a computer that is connected to the same network that will be used by the BLE node:
- Open the application.
- Click on the RELOAD button in the top-left corner of the application.
- Select the BLE node to be configured from the drop-down menu.
- From the Dashboard tab take note of the MAC address of this device.
- Click on the Application tab. Set these parameters:
- Connection Type: MQTT Client
- Host: navimote2.navizon.com
- Port: 1883
- Publish Topic: beacons (please note that even though the value is shown by default, you need to actually type it in the text field!)
- Request Interval: 3
- Advertising Filter: iBeacon Only
- Click on Save.
- Click on the Advanced tab and click on Restart.
- (OPTIONAL WiFi configuration) after having performed the steps above the BLE node will be able to connect to the network using an Ethernet cable. If you want to configure the BLE node so that it uses a 2.4 GHz WiFi network then you have to:
- Click on the Network tab.
- Inside the Wi-Fi SSID field type the SSID of the permanent WiFi network to be used by the BLE nodes.
- Inside the Security Key field type the password of the permanent WiFi network (or select Open Wi-Fi Network if the network does not require a password). The permanent WiFi network is a 2.4 GHzWi-Fi network that covers ENTIRELY the area in which the BLE nodes will be installed.
- Click on Save.
- Click on the Advanced tab and click on Restart.
Repeat the configuration for all the nodes starting from Step 3 and do not touch any other parameter! DO NOT upgrade the firmware on the BLE nodes.
1.2 – Using a REST API client
- Turn on the BLE node that you want to configure and connect it to the network using an Ethernet cable.
- 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.
- 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“.
- Take note of the IP address assigned to the BLE node (the MAC address of the BLE node is the one printed on the side of the node).
- Install a REST client (like cURL) on a computer connected to the same network that will be used by the BLE node and issue the following POST call from the shell:
curl http://IP address/config -d "conn-type=3&mqtt-host=navimote2.navizon.com&mqtt-port=1883&mqtt-topic=beacons&req-int=3&min-rssi=-127&adv-filter=1&dup-filter=0" -X POST -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8"
- (OPTIONAL WiFi configuration) after having performed the steps above the BLE node will be able to connect to the network using an Ethernet cable. If you want to configure the BLE node so that it uses a 2.4 GHz WiFi network then you have to issue the following POST call from the shell:
curl http://IP address/connection -d "ssid=WIFI_NAME&passcode=WIFI_PASSWORDð-dhcp=1ð-ip=ð-gateway=ð-netmask=" -X POST -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8"
Repeat the configuration for all the nodes starting from Step 1.
Step 2 – Physical installation of the nodes
During the physical installation of the nodes:
- print the floor plan uploaded inside the Accuware dashboard
- 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 side of each node.
- install the nodes in the environment keeping into account 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 nodes
You will have to position each node on the floor plan. To set the nodes positions, please:
- Select BT Beacon Tracker > Nodes
- 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).
- 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.
- 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.
- 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:
- Click on the BT Beacon Tracker > Map.
- Turn on a BLE beacon!
- Verify that all the nodes are active (green). The green color indicates that the nodes are reporting data to the Accuware server.
Test Bluetooth Beacon Tracker
You can now test the tracking capabilities of Bluetooth Beacon Tracker by following the instructions inside this support page.