Pre-requirements
In order to proceed with the configuration of your BLE nodes you need to have:
- The credentials to access the Indoor Tracking Dashboard.
- One or more BLE nodes (based on the type of deployment chosen).
- At least 1 BLE beacon already configured.
Each one of the BLE nodes must be configured properly to communicate with the Indoor Tracking server. These are the 3 things that need to be configured:
- the Internet connection that will be used by the BLE nodes to communicate with the Indoor Tracking server. Inside this page you can find the specifications of the Internet connection.
- the endpoint of the MQTT broker/client.
- the transmission frequency (a.k.a. the Request interval).
The configuration of the BLE nodes can be done using one of the following methods (in order of preference).
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: its.stura.io
- 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.
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.
Configure the BLE nodes to connect to a Wi-Fi network
-
- Click on the Network tab.
- Inside the Wi-Fi SSID field type the SSID of the Wi-Fi network to be used by the BLE nodes.
- Inside the Security Key field type the password of the Wi-Fi network (or select Open Wi-Fi Network if the network does not require a password). The Wi-Fi network is a 2.4 GHz Wi-Fi network that covers the area in which the BLE nodes will be installed.
- Click on Save.
- Click on the Advanced tab and click on Restart.
Using an API POST call
- 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 router.
- 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 Wi-Fi router and the IP assigned to each one of them).
- 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=its.stura.io&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"
Repeat the configuration for all the nodes starting from Step 1.
Configure the BLE nodes to connect to a Wi-Fi network
Issue the following POST call from the shell:
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"