Introduction
ioTracker Multi-sensor tracker ioTracker is a compact multi‑sensor LoRaWAN® tracker with built‑in temperature, light, shock, tilt, optional humidity and pressure sensors for versatile environment monitoring.
The ioTracker contains multiple pre-set
configurations, which can cover many use
cases. If needed, the individual parameters
can be tuned to match your business
needs. Almost every setting of the ioTracker
can be changed — over-the-air (OTAA) —
allowing you to reconfigure / repurpose
your ioTrackers wherever they are.
The ioTracker features multiple localisation
features: GPS, Wi-Fi, Bluetooth LE and
LoRaWAN. This provides the best balance
between high-accurate positioning and
power efficiency in almost every in- and
outdoor situation.
Only Professional Edition supports Platform Integrations feature.
Use ThingsBoard Cloud or install your own platform instance.
Prerequisites
To continue with this guide we will need the following:
- ioTracker Multi-sensor tracker
- LoRaWAN® gateway (in our case UG56 LoRaWAN® Gateway)
- Configured integration on networks server and ThingsBoard
- ThingsBoard account
Device connection
Device configuration
To connect and send data we should configure the device and network server.
At first we are going to configure the device, and save required information for network server configuration.
To add a device to network server and get information from it, we will need the following device parameters:
- Device EUI — device identifier
- Application EUI — application identifier
- Application Key — application key to identify device. We recommend to use a generated key, not from the example!
The parameters above are required for connection.
Depending on the network server, you may also need to provide join type (OTAA) and LoRaWAN version.
Prerequisites
- Android app & account
Install the ioTracker Configurator app from Google Play and log in with your ioTracker account. - Device compatibility
Only with ioTracker accounts after February 1, 2022 are supported. - Bluetooth & permissions
Enable Bluetooth and grant Location/”Nearby devices” permissions to the app.
1. Scanning & Connecting
- Open ioTracker Configurator and tap Refresh (or Scan) to discover devices.
- Select your ioTracker or ioButton from the list and tap Login; enter your credentials to establish Bluetooth.
2. LoRaWAN Menu
From the Main menu, tap Configuration to access LoRaWAN functions.
Change LoRaWAN Keys
- Click the edit/pencil icon next to DevEUI, AppEUI, and AppKey.
- Enter your new LoRaWAN DevEUI, AppEUI, and AppKey.
- Click Update.
- Reboot the device to activate the new keys.
Check LoRaWAN Status
- Active Region: the frequency band in use.
- LoRaWAN Version: the specification version.
- Join Status: JOINED or NOT JOINED.
- Last Uplink: timestamp, payload, message type, DataRate, channel, TxPower, TxToA, UpCntr.
- Last Downlink: timestamp, payload, DataRate, RxSlot, port, RSSI, SNR, ACK flag, DownCntr.
To configure the device we also need to add it to a network server, so select the network server your gateway is connected to:
Add a device on the ChirpstackWe need to add a device on the Chirpstack. To add a device, you can follow next steps:
 Login to Chirpstack server.  Go to the Device profiles page and click on Add device profile button.  Fill the fields and click on Submit button.  Go to the Applications page, click on your application and press Add device button.  Fill parameters with values from the device configuration. Then choose previously created device profile and click on Submit button.  Put your Application key to the field and click on Submit button to save the device. Uplink converter in ThingsBoard integrationStep 1: Download the JSON file Download the JSON file with the uplink converter settings by clicking the button below. Download uplink converter for ChirpStack integration.
After downloading the file with the Uplink converter configuration, import it into ThingsBoard:
 Navigate to the “Data converters” page in the “Integration center” section. Click the “+” icon in the top-right corner of the page and select “Import converter” from the drop-down menu.  Drag and drop the downloaded JSON file (containing the uplink converter configuration) into the import window, then click “Import”.  The uplink converter is now successfully imported.
Now, let's update your ChirpStack integration to use the new uplink converter:
 Go to the “Integrations” page in the “Integration center” section. Click on your ChirpStack integration to open its details window. Enter edit mode by clicking the orange pencil button in the top-right corner.  Replace the existing uplink converter with the imported one.  Don't forget to save your changes! |
Add a device on The Things Stack Community EditionWe need to add a device on The Things Stack Community Edition. To add a device, you can follow next steps:
 Login to the cloud and open your console.  Go to the Applications page. Then select your application and click on its name.  Click on the Register end device button.  Put the APP EUI value to the JoinEUI field. Press the Confirm button.  Fill the rest parameters and press Register end device button. Uplink converter in ThingsBoard integrationStep 1: Download the JSON file Download the JSON file with the uplink converter settings by clicking the button below. Download uplink converter for The Things Stack integration.
After downloading the file with the Uplink converter configuration, import it into ThingsBoard:
Navigate to the “Data converters” page in the “Integration center” section. Click the “+” icon in the top-right corner of the page and select “Import converter” from the drop-down menu. Drag and drop the downloaded JSON file (containing the uplink converter configuration) into the import window, then click “Import”.  The uplink converter is now successfully imported.
Now, let's update your The Things Stack integration to use the new uplink converter:
 Go to the “Integrations” page in the “Integration center” section. Click on your The Things Stack integration to open its details window. Enter edit mode by clicking the orange pencil button in the top-right corner.  Replace the existing uplink converter with the imported one.  Don't forget to save your changes! |
Add a device on The Things IndustriesWe need to add a device on The Things Industries cloud. To add a device, you can follow next steps:
 Login to the cloud and open your console.  Go to the Applications page. Then select your application and click on its name.  Click on the Register end device button.  Put the APP EUI value to the JoinEUI field. Press the Confirm button.  Fill the rest parameters and press Register end device button. Uplink converter in ThingsBoard integrationStep 1: Download the JSON file Download the JSON file with the uplink converter settings by clicking the button below. Download uplink converter for The Things Industries integration.
After downloading the file with the Uplink converter configuration, import it into ThingsBoard:
Navigate to the “Data converters” page in the “Integration center” section. Click the “+” icon in the top-right corner of the page and select “Import converter” from the drop-down menu. Drag and drop the downloaded JSON file (containing the uplink converter configuration) into the import window, then click “Import”.  The uplink converter is now successfully imported.
Now, let's update your The Things Industries integration to use the new uplink converter:
 Go to the “Integrations” page in the “Integration center” section. Click on your The Things Industries integration to open its details window. Enter edit mode by clicking the orange pencil button in the top-right corner.  Replace the existing uplink converter with the imported one.  Don't forget to save your changes! |
Add a device on the LoriotWe need to add a device on the Loriot. To add a device, you can follow next steps:
 Login to Loriot server. We use eu2.loriot.io, but it depends on chosen region during registration.  Go to the “Applications” page in left menu.  Open your application, in our case it is “SampleApp”.  Go to the “Enroll Device” page. Fill in the fields, with a configuration from your device. Then click the “Enroll” button. Uplink converter in ThingsBoard integrationStep 1: Download the JSON file Download the JSON file with the uplink converter settings by clicking the button below. Download uplink converter for Loriot integration.
After downloading the file with the Uplink converter configuration, import it into ThingsBoard:
Navigate to the “Data converters” page in the “Integration center” section. Click the “+” icon in the top-right corner of the page and select “Import converter” from the drop-down menu. Drag and drop the downloaded JSON file (containing the uplink converter configuration) into the import window, then click “Import”.  The uplink converter is now successfully imported.
Now, let's update your Loriot integration to use the new uplink converter:
 Go to the “Integrations” page in the “Integration center” section. Click on your Loriot integration to open its details window. Enter edit mode by clicking the orange pencil button in the top-right corner.  Replace the existing uplink converter with the imported one.  Don't forget to save your changes! |
Check data on ThingsBoard
After the device is connected to the network server and ThingsBoard, you can check received and converted data on the platform for this device.
To do this, open Entities menu section and select Devices.
Click on the device name to open the device details page.
Go to the Latest telemetry tab to see the latest telemetry data received from the device.
Conclusion
With the knowledge outlined in this guide, you can easily connect your ioTracker Multi-sensor tracker and send data to ThingsBoard.
Explore the platform documentation to learn more about key concepts and features. For example, configure alarm rules or dashboards.