PLEASE READ: If you need information about:

  • OLD BLE nodes (V1) with external antennas please refer to this page.
  • BLE nodes (V2) without external antennas 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 devices detected. This means that the locations (latitude and longitude) of all the BLE devices 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 devices 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.


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

Step 1 – Configuration of the BLE 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 endpoint, port and topic of the Accuware MQTT broker/client.
  • the transmission frequency (aka the Request interval).

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

1.1 – Using a desktop application for Windows/Ubuntu

  1. Turn on the BLE node that you want to configure and connect it to the network using an Ethernet cable.
  2. Install the configuration application on a computer connected to the same network that will be used by the BLE node:
  3. Open the application.
  4. Click on the RELOAD button in the top-left corner of the application.
  5. Select the BLE node to be configured from the drop-down menu.
  6. From the Dashboard tab take note of the MAC address of this device.
  7. Click on the Application tab. Set these parameters:
    • Connection Type: MQTT Client
    • Host:
    • 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
    • Do not touch any other parameter! DO NOT upgrade the firmware on the BLE node.
  8. Click on Save.
  9. Click on the Advanced tab and click on Restart.

1.2 – Using a REST API client

  1. Turn on the BLE node that you want to configure and connect it to the network using an Ethernet cable.
  2. 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.
  3. 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“.
  4. 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).
  5. 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&" -X POST -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8"
  6. (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&eth-dhcp=1&eth-ip=&eth-gateway=&eth-netmask=" -X POST -H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8"

Step 2 – Physical installation of the node

During the physical installation of the node take note of the MAC address and its location. The MAC address is printed on a label on the side of the node. Install the node in the environment following carefully the information inside the paragraph 2.3 – Physical location of this support page.

BLE Node V4

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 SaveIf 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 one of the BLE devices (previously configured with the parameters described inside this page).
  3. Verify that the node is active (green). The green color indicates that the node is 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.