Star

Connect Tektelic LoRaWAN sensors using TEKTELIC KONA Core Network Server

Tektelic is a premier supplier of LoRaWAN® IoT Gateways, Sensors and custom applications.
This guide describes how to stream data from TEKTELIC KONA Core Network Server to ThingsBoard.

Prerequisites

A gateway and a sensor that is designed to work in EU868 frequency band will be used.

To start it necessary to have:

The common scheme of the guide setup is the next:

Step 1. Register hardware in Network Server

Step 1.1 Add a gateway

Network Server provides a predefined list of the gateways and here is using Kona Micro EU GW model.
You also could create a new one gateway model, set a frequency band and number of channels according to a gateway specification.

Tektelic gateways are supplied with a predefined Network Server address - lorawan-ns-eu.tektelic.com for EU868 gateways and lorawan-ns-na.tektelic.com for US915 gateways.
After a gateway was created at Network Server and connected to the Internet, its status is set to Online.
The gateway’s STATISTICS tab is updating periodically and shows how many packets were sent and received through a radio channel.

Step 1.2 Add a sensor

QR code contains Device EUI and Application EUI values.

Where 647FDA00000042F0 is Device EUI and 647FDA8010000100 is Application EUI.
Tektelic provides a hard copy containing commissioning information with shipment of sensors. If you don’t find it, then contact Tektelic support

After the sensor is provisioned, it is necessary to turn it on to get LoRa packets in Network Server.
The Smart Room Sensor will turn on after pulling out a protecting film. After that operation, the sensor will be supplied from a battery installed at a factory.
As a result, join request-accept packets will be displayed in the REAL-TIME PACKETS tab.
And, later on, uplink and downlink will be displayed too.

Smart Room Sensor sends the uplinks periodically, but you can trigger an uplink with a magnet.
It is enough to bring closer a magnet to the sensor body.
Network Server shows packets in encoded Base64 form. To decode a packet and see the whole LoRa packet payload, including LoRa related data and the sensor data itself, you could use a free LoRaWAN 1.0.x packet decoder.
The decoder requires Application and Network session keys could be found in the ACTIVATION tab.

Be aware, Application and Network session keys are changing whenever a sensor has been rejoined.
Smart Room Sensor is rejoining every time after the battery has been disconnected.

Step 2. Configure integration with ThingsBoard

ThingsBoard provides MQTT Gateway API.
Network Server integration, in turn, uses this MQTT Gateway API.
So sensors and gateways will be created automatically at ThingsBoard side.

Step 2.1 Add a gateway device in ThingsBoard

Step 2.2 Add an integration in Network Server

Open Local sensors application in Network Server and click MANAGE INTEGRATIONS button.
Now it’s necessary to create a new integration with a ThingsBoard.
Click the Add integration icon in the right top corner and set the next fields:

Leave the rest of the fields with default values.

Step 3. Integration verification

After the integration has been created, wait for a new uplink (or trigger it) from the sensor.
Only after a new uplink Network Server, through MQTT Gateway API, will create new devices in ThingsBoard.
In ThingsBoard open device-gateway from step 2.1, go to the RELATIONS tab, and select outbound relations with a direction From.
There should be present the gateway and the sensor added in Network Server at Step 1.1 and Step 1.2



These devices will be displayed with an appropriate type:

Open the sensor’s LATEST TELEMETRY tab, it will contain data that Network Server sent in the last message.
Part of the data (nsGateway, nsRssi, nsFPort, for example) is related to LoRa, to Network Server, and to the gateway which receives an uplink.
The rest of the data is added by Network Server converter (in our case - by Tektelic Home Sensor from Step 2.2), and it is related to the sensor’s payload (humidity, accelerometer, Impact, etc.).
This part of telemetry data depends on Network Server converter used for a ThingsBoard integration and how that converter parses the sensor’s payload (array of bytes) into JSON at Network Server side.
So if you are using another model of the sensor, please take it into account.

Once integration verification passed successfully, the received telemetry is available for visualization.
You can import the predefined dashboard to see the data. Click to download.

Next steps

Explore guides related to main ThingsBoard features: