Basic Station Interface for AWS IoT core for LoRaWAN

Basic Station Interface for AWS IoT core for LoRaWAN

To download software packages required to support Basic Station interface on Kona Gateways (Micro/Macro/Mega) for AWS IoT core for LoRaWAN along with instructions for installation, please see the attachment below.  Attachment section contains three files as described below.

                                            File
                                       File Name
1) Quick Start Guide
Tektelic_Gateway_with_AWS_IOT_Core_for_LoRaWAN_Getting_Started_Guide_v3
2) Software packages in zip file 
Basic-Station-packages-v1.5.1-for-Tektelic-gateways.tar.gz
3) Read Me (captures instructions to install software packages)
README.tektelic-basic-station


Basics Station & TEKTELIC MQTT Bridge Conflict

Please note that from the factory, TEKTELIC gateways are configured to connect to TEKTELIC Network Server. This means that once the Gateway connects to AWS IoT Core, it is important to make sure that the MQTT Bridge on the gateway does not connect to TEKTELIC Network Sever as the gateway will NOT be able to connect to both Network Servers at the same time. However, the gateway can be configured to connect to TEKTELIC OAM Server and AWS IoT Core at the same time.
      
Please note that the MQTT Bridge configuration file is located at /etc/default/mqtt-bridge.conf on gateways with older BSP versions. On newer gateway BSP versions, this file is located at /etc/default/tektelic-bridge.ns.toml and /etc/default/tektelic-bridge.oam.toml and cannot be accessed / edited via KonaFT. On newer BSP gateways, the file must be edited by using the vi text editor from the gateways SSH command line.

  Subband conflict

      Please be noted that by default AWS IoT Core use 2nd subband in US915 and AU915 regions.
      So for correct work you should change default subband in AWS IoT Core settings or make changes on GW in config.json file.

Configuration of MQTT Bridge without OAM Server

  1. If you are not using  TEKTELIC OAM Server , we highly recommend you check it out. If you require an account, please let us know, we can create an account for you. The TEKTELIC OAM Server provides various Remote Management and Monitoring features for Gateways. Please refer to TEKTELIC OAM Server User Guide for more information.
    1. Comment ns_host  field with a # at the beginning of the line
    2. Comment ns_type field with a # at the beginning of the line
    3. Comment gw_user field with a # at the beginning of the line
    4. Comment gw_password field with a # at the beginning of the line
  2. After saving the file please restart TEKTELIC MQTT Bridge and Basics Station with the commands below:
$      /etc/init.d/mqtt-bridge restart
$      /etc/init.d/tektelic-bstn restart

Configuration of MQTT Bridge with OAM Server

  1. If you are using TEKTELIC OAM Server, you will have to edit the /etc/default/mqtt-bridge.conf file as follows.
    1. Comment ns_host  field with a # at the beginning of the line
    2. Comment ns_type field with a # at the beginning of the line
    3. Comment gw_user field with a # at the beginning of the line
    4. Comment gw_password field with a # at the beginning of the line
    5. Uncomment oam_host filed by removing the # at the beginning of the line
    6. Uncomment gw_oam_user field by removing the # at the beginning of the line
    7. Uncomment gw_oam_password field by removing the # at the beginning of the line

  2. After saving the file please restart TEKTELIC MQTT Bridge and Basics Station with the commands below:
$      /etc/init.d/mqtt-bridge restart
$      /etc/init.d/tektelic-bstn restart

Setup Gateway with Basics Station

WARNING
INFO : Either a Linux machine or  Windows Subsystem for Linux  (WSL Ubuntu) is required for following along in this guide. For all the terminal commands in this document, please  DO NOT enter $. It is used to indicate the beginning of a new command.

Login to the gateway using SSH with the following command:
NOTE: For the commands below, please replace  gateway-ip with the IP Address of your gateway.
$      ssh root@ gateway-ip
Enter the password of the gateway when requested (9-Digit Serial Number by default).
You can find the current Basics Station version (if installed) on the gateway with the following command:
$      opkg info tektelic-bstn | grep Status
The latest version of Basics Station is v1.7.0. This Basic Station package is uploaded to the gateway during the BSP Upgrade to the newest BSP. If you are not on the latest BSP version please upgrade your gateway BSP to the newest version and run the following commands:
$      opkg update
$      opkg install tektelic-bstn curl libcurl4
After running the above commands please make sure that in /etc/default/config.json the server_address field has a value of "127.0.0.1". In addition, add report_count: 1, in the gateway-conf section of the file if this is not already present.
Customer with a US gateway, need to make sure that the /etc/default/config.json file is configured for the 2nd sub-band of frequencies in US915



    • Related Articles

    • Configuration of Basic Station for Kona Micro Lite Gateway- AWS IoT

      To download the binary file required to support the Basic Station interface on the Kona Micro Lite gateway for AWS IoT along with instructions for installation, please see the attachment below. The attachment section contains two files as described ...
    • Basic Station Interface for TTNv3

      To download software packages required to support Basic Station interface on Kona Gateways (Micro/Macro/Mega) for TTNv3 along with instructions for installation, please see the attachment below.  Attachment section contains three files as described ...
    • Configuration of Basic Station for Kona Micro Lite Gateway- TTNv3

      To download binary file required to support Basic Station interface on Kona Micro Lite gateway for TTNv3 along with instructions for installation, please see the attachment below. Attachment section contains two files as described below. ...
    • Azure IoT Integration

      This guide describes the procedure for Azure IoT Central platform integration with Tektelic NS.
    • Cellular Interface Configuration on Kona Micro Gateway

      To access the document outlining the procedure to configure cellular interface on Kona Micro Gateway, you can go to attachment section of this article.