Skip to content
English
Sign in
Contact us
  • There are no suggestions because the search field is empty.

Tektelic LNS Quick Start Guide

Introduction

This article is intended for service providers and power users looking to build their first LoRaWAN network using the Tektelic LoRaWAN Network Server. In this guide, an end-to-end LoRaWAN setup is demonstrated in the US915 LoRaWAN region. Region-specific settings are documented elsewhere.

LoRaWAN architecture:

  • LoRaWAN End Node (Sensor): Measures data (e.g., temperature) and reports it via LoRaWAN uplink.

  • LoRaWAN Gateway: Receives LoRaWAN uplinks from sensors and forwards them to the LoRaWAN Network Server. It also receives LoRaWAN downlinks from the network server and transmits them to the sensors.

  • LoRaWAN Network Server (LNS): Receives LoRaWAN uplinks from the gateway, decrypts and decodes them, and forwards the data to the Application Server via HTTP or MQTT. The Tektelic LNS also provides integrated Tektelic Gateway management and sensor RF (Radio Frequency) troubleshooting information.

  • Application Server (AS): Responsible for data storage, data visualization, and remote control. All post-processing occurs here.

Step 0. Registering Your First Account on Tektelic LNS

  1. Contact Tektelic Sales to request a trial account for Tektelic LNS.

  2. You will receive an activation link and be informed of the email address registered under this account.

  3. Use the activation link to set up your password.

  4. Log in using your email address and password.

  5. This is the home page

 LNS 1

 

Step 1. Register your first gateway:

Before starting, locate your gateway testing certificate, which is shipped inside the gateway box.

Test Cert

If it is missing, please contact your Tektelic Sales representative, or Tektelic Support.

  1. Click on the Gateway Groups tab at the top left.

  2. Click the plus sign at the top left.

  3. Name the gateway group.

  4. Once created, click the Manage Gateway button on the left.

    Gateway Group

  5. Navigate to the Gateway Group page and click the plus sign on the top right.

  6. Locate your gateway test certificate and input your gateway name and GWID from the label.

  7. Choose the appropriate gateway type.

  8. After creating the gateway, click the Manage Credential button.


    Gateway Creds

  9. Input the Network Server User and Network Server Pass from the test certificate.

  10. Your gateway registration is complete.

  11. Power on the gateway and connect the Ethernet cable.

Important: The gateway operates in DHCP mode by default. Ensure that a DHCP server is available in your network. The easiest approach is to connect the gateway to a router that assigns an IP address. Once configured, your gateway should appear online in the Tektelic LNS.

Step 2. Register your first sensor:

  1. From the Tektelic LNS Home Page, click Applications on the left.

  2. Click the plus sign at the top right and name your application.

  3. Once created, click the application name to open its settings.

    Sensor Application

  4. In the application tab, click Advanced Network Settings.

  5. Scroll down to Channel Mask and select 8 channels (assuming a Kona Micro 8-channel gateway for this guide).

    Channel mask 1

  6. Click the check button to save.

  7. Click Manage Devices.

    Manage Devices

  8. In the Application: Device page, click the plus sign on the top right.

  9. Enter the following details:

    • Device name

    • Device model (For simplicity, use "COMFORT" for all Class A sensors , you can create a device model as well.)

    • devEUI

    • AppEUI/JoinEUI

    • AppKEY

    • Check Use Application Settings

  10. Power on your sensors. Within 2-5 minutes, they should appear online.

Step 3. Create your first data converter:

A JavaScript function called a data converter can be imported into Tektelic LNS. Every time the Tektelic LNS receives an uplink from a sensor with an assigned data converter, it will invoke the converter. For example, a data converter can transform sensor-reported bytes (e.g., 0x03 0x67 0x05) into human-readable JSON data, such as:

{"temperature": 5}

  1. From the Tektelic LNS Home Page, click Data Converters on the left.

  2. Click the plus sign on the top right.

  3. To input a customized JavaScript data converter, choose Customer v2.

  4. All Tektelic sensors' V2 Data Converters can be found here:

addDecoder

  1. Paste the entire text into the decoder box and click ADD.
  2. For third-party sensors, contact Tektelic Support.

Step 4. Create your first integration:

Integration is the LNS and AS communication. Tektelic LNS will forward the decoded uplinks to AS.

  1. From the Tektelic LNS Home Page, click Applications.

  2. Click Manage Integrations.

    Integrations

  3. In the Application: Integration page, click the plus sign on the top right.

  4. Provide a name and select either HTTP v2 or MQTT v2 as the type.

  5. Contact Tektelic Support for further details.

Integration Setup Documentation:

Integration Types:

  • HTTP v2:

  • MQTT v2:

    • Supports an extended list of MQTT configuration parameters.

    • Supports Data Converter v2 with an extended list of metadata parameters.

    • Note: Only Data Converter v2 can be used.

    • More details: MQTT V2 Integration | Documentation (Beta)