Kona Gateways
      Back to home
      1. Knowledge Hub
      2. Kona Gateways

      Connecting Kona Gateways to 3rd-party Network Servers

      This article applies to ALL Kona Gateways except for Micro-Lite/Pico. 

      Introduction

      All Kona gateways that come out of the factory are configured to connect to TEKTELIC CORE Network Server (NS) by default. Customers can configure Kona gateways to connect to other network servers.
      This article will outline the following:
      1. Preparing the gateway before onboarding it onto another NS.
      2. Reinstalling pieces of software that other NS may require you to remove.
      3. Instructions to connect to other network servers.
      NOTE: This article WILL NOT list all compatible NS with Kona Gateways, only those that have instructions provided by TEKTELIC.
      NOTE: Excluding Basic Station and Chirpstack, support for onboarding gateways onto 3rd-party network servers will be limited.
      The instructions will assume that you have the TEKTELIC MQTT Bridge disabled. We highly recommend you read the "Gateway Preparation" section before proceeding with ANY of the sections mentioned below.

      Gateway Preparation

      Kona gateways have two components it uses to connect to TEKTELIC CORE NS.

      1. Kona Packet Forwarder, our implementation of the Semtech packet forwarder.

      2. TEKTELIC MQTT Bridge, used to connect to TEKTELIC CORE NS.

      When connecting to a 3rd-party NS, we recommend disabling the TEKTELIC MQTT Bridge to avoid potential network conflicts.

      If you have no intentions of using TEKTELIC OA&M server as an additional vector to manage your gateway, please SSH into the gateway enter the following command:  opkg remove tektelic-mqtt-bridge

      If you intend on using TEKTELIC OA&M server, please follow the instructions below to download and modify the requisite files.
      Advanced users can also SSH into the gateway and directly edit the files seen below using vi.
      To download the files, use  FileZilla to access the gateway with the following credentials:
      1. Host: Gateway IP
      2. Username: root OR admin
      3. Password: 9-digit SN (i.e. 1212A3434) OR randomized password found on the test report.
      4. Port: 22
      Once you are logged in, navigate to the following remote site:  /etc/default
      Download the following files:
      1. mqtt-bridge.conf
      2. tektelic-bridge.ns.toml
      3. tektelic-bridge.oam.toml
      On older versions of Kona gateways, the MQTT-bridge uses  mqtt-bridge.conf for configuration. On newer versions, this is split into  tektelic-bridge.ns.toml and  tektelic-bridge.oam.toml
      1. If you only have mqtt-bridge.conf, follow the guidelines for that file alone.
      2. If you have both tektelic-bridge.ns.toml and tektelic-bridge.oam.toml, follow the guidelines for BOTH files.

      mqtt-bridge.conf

      1. To comment out a line, insert a "#" without quotes in front of the line.
      2. To remove the comment, simply delete the "#" without quotes in front of the line.
      Ensure that the following lines  HAVE A   "#" in front of the line and are configured as follows:
      1. #ns_host         lorawan-ns-na.tektelic.com
      2. #ns_type         tektelic
      3. #gw_user       TEK0XXYYZ (where XXYYZ is the last 5 digits of the GWID) 
      4. #gw_password        1212A3434 (This is an example SN. The SN can be found on the back of your gateway)
      Ensure that the following lines  DO NOT  have  "#" in front of the line and appears as follows:
      1. oam_host
      2. gw_oam_user
      3. gw_oam_password

      tektelic-bridge.ns.toml

      Ensure that the following lines  HAVE A   "#" in front of the line and are configured as follows:
      1. #url = "lorawan-ns-na.tektelic.com"
      2. #type = "tektelic"
      3. #gw_user = "TEK0XXYYZ" (where XXYYZ is the last 5 digits of the GWID) 
      4. #gw_password = "1212A3434" (This is an example SN. The SN can be found on the back of your gateway)

      tektelic-bridge.oam.toml

      Ensure that the following lines  DO NOT  have  "#" in front of the line and appears as follows:
      1. oam_host
      2. gw_oam_user
      3. gw_oam_password
      Once all files have been reconfigured, reinsert the files through FileZilla and overwrite the existing ones. Then finalize by power-cycling the gateway.

      Kona Software reinstallation

      In the event you wish to reinstall the TEKTELIC MQTT bridge or the Kona Packet Forwarder, please follow the high level steps below:
      1. Determine BSP version of the gateway.
      2. Download the BSP package.
      3. Upload the package(s) onto the gateway.
      4. Reinstall package(s).
       
      Software required:
      1. FTP software such as FileZilla
      2. SSH software such as PuTTY or TeraTerm
      Determine BSP version of the gateway
      There are two methods to check the BSP version of the gateway.
      1. Through KonaFT
      2. Through SSH

      KonaFT

      Ensure that the computer and gateway are on the same computer network. Then follow the steps below:
      1. Connect to the gateway.
      2. Look for the BSP version of your gateway at the bottom right of the application.
       

      SSH

      To determine the BSP version of the gateway, follow the below steps:
      1.  SSH into the gateway IP.
      2. Enter the following command: system_version
      The gateway IP can be found by matching the IP to the gateway's MAC address. All Kona gateways will have a MAC address beginning with 64:7F:DA
      Download BSP package
      BSP packages can be found and downloaded from the TEKTELIC FTP server.
      To download the files, use  FileZilla (or similar) to access the FTP server with the following credentials:
      1. Host: 74.3.134.34
      2. Username: customer
      3. Password: vU6_ATR3
      Additional configuration is required as the TEKTELIC FTP server uses encryption. As such, when using FileZilla, navigate to the site manager (Top left of the screen, File -> Site Manager) to configure the site as seen below.
      Once connected, navigate to the BSP version corresponding to your gateway. Download it to a location you can keep track of, and extract the contents of the BSP package.
       
      The packages for the Kona Packet forwarder and the TEKTELIC MQTT bridge can be found in the "bsp" folder. The filenames are as follows:
      1. kona-pkt-forwarder_X.X.X-rXXX_kona.ipk
      2. tektelic-mqtt-bridge_Y.Y.Y_rYY_kona.ipk
      Note: The letters XY are placeholders for version numbers appropriate for the BSP.
      Upload package(s) onto the gateway
      To upload the files to the gateway, use  FileZilla  (or similar)   to access the gateway with the following credentials:
      1. Host: Gateway IP
      2. Username: root OR admin
      3. Password: 9-digit SN (i.e. 1212A3434) OR randomized password found on the test report.
      4. Port: 22
      Once connected, place the files in the initial remote site.
      Pictured above is the initial site for gateways that use root as the username. The initial remote site for gateways that use admin as the username have a slightly different path: /home/admin
       
      Reinstall package(s)
      To reinstall packages through SSH, login to the gateway IP and enter the following commands as required:
      1. opkg install kona-pkt-forwarder
      2. opkg install tektelic-mqtt-bridge
      To reinstall packages through KonaFT, connect to the gateway and follow the steps below:
      1. Navigate to Board Details → SW Management.
      2. In the top right corner, click  Read Installable to see a list of packages available on your gateway.
      3. Under the column Component, click on the package you wish to install and select Install Selected in the top right.
      1. For Kona packet forwarder, select kona-pkt-forwarder
      2. For MQTT bridge, select tektelic-mqtt-bridge
      AWS IoT Core
      NOTE: Customers with NA Micro/Enterprise will have to configure their gateways to use the 2nd US915 sub-band. Additional instructions are provided in the guide.
      AWS IoT Core primarily uses our implementation of Basic Station for NS connections.
      1. Guide to connect to AWS IoT Core
      The Things Network V3 (TTNv3)
      NOTE: Customers with NA Micro/Enterprise will have to configure their gateways to use the 2nd US915 sub-band. Additional instructions are provided in the guide.
      TTN can be connected through two methods:
      1. Using the Kona Packet Forwarder (UDP)
      2. Using Basic Station
      This section will only cover Kona Packet Forwarder, as the Basic Station guide is linked above. Using the Kona Packet Forwarder is the simplest way to connect to TTN. It is broken up into 2 steps:
      1. Create gateway object on TTN.
      2. Configure gateway.
      Create gateway object on TTN
      On your TTN instance, create a new gateway and assign the settings depicted below:
      Please fill out the fields in accordance with the label on the gateway. The blank Gateway EUI, Gateway ID (GWID), and Gateway name in the picture are only used for reference.
      Ensure that none of the following checkboxes are ticked:
      1. Require authenticated connection
      2. Share status within network
      3. Share location within network
      For users with a NORTH AMERICAN Kona Micro/Enterprise, select United States 902-928 MHz, FSB 2 (used by TTN) as the frequency plan.
      Once created, note the gateway server address for when you configure the gateway.
       
      Configure Gateway
      The simplest way of configuring the gateway is through KonaFT.  Ensure that the computer and gateway are on the same computer network.  Then follow the steps below:
      2. Select the  configuration tab at the top.
      3. In the field, enter  /etc/default/config.json and then click  Read to see the contents of the configuration file.
      4. Configure the server address to reflect the Gateway Server address seen above.
       
      For users with a NORTH AMERICAN Kona Micro/Enterprise, the gateway will need to be configured to use the 2nd US915 sub-band in addition to changing the server address. In this case, please follow the steps below:
      1. Download the config.json found here.
      2. Open the newly downloaded config.json file and copy everything in the file (Ctrl+C)
      3. Replace all contents of the config.json in KonaFT (Ctrl+A -> Ctrl+V)
      4. Configure the server address to reflect the Gateway Server address seen above.
      5. Continue with steps 5 and 6 below.
      5. Finalize by selecting  Write .
      6. Reboot the gateway by clicking  Reboot.
       
      ChirpStack
      Kona gateways can connect to Chirpstack through two methods:
      1. Using the Kona Packet Forwarder (UDP)
      2. Using ChirpStack's Gateway Bridge
      Using Kona Packet Forwarder
      Using ChirpStack's Gateway Bridge (ADVANCED USERS ONLY)
      Customers can use ChirpStack's Gateway Bridge on Kona Gateways to connect to their instance of ChirpStack.
      Please follow the steps below:
      1. Follow the instructions on ChirpStack's website to install the GW bridge.
      2. Use vi to edit the following file: /etc/chirpstack-mqtt-forwarder/chirpstack-mqtt-forwarder.toml
      3. Under MQTT settings, change the server field to the URL of your ChirpStack instance.
      NOTE: Outside of these instructions, TEKTELIC does not provide support for additional methods of connecting to ChirpStack.
      Loriot
      Loriot offers a unique packet forwarder that requires the removal of the Kona Packet Forwarder.
      Please follow the steps below:
      The gateway IP can be found by matching the IP to the gateway's MAC address. All Kona gateways will have a MAC address beginning with  64:7F:DA
      1. SSH into the gateway IP.
      2. Remove the Kona Packet Forwarder with the following command: opkg remove kona-pkt-forwarder
      3. Remove or reconfigure the TEKTELIC MQTT bridge as required.
      4. Provision the gateway on Loriot.
      5. On the left side of the gateway page, select Software and you will find the instructions for installing Loriot software.
      Other
      NOTE: When connecting to unlisted 3rd-party Network Servers, support from TEKTELIC will be limited.
      Some network servers have instructions to configure the Semtech packet forwarder on 3rd-party gateways. As the Kona Packet Forwarder is TEKTELIC's implementation of the Semtech packet forwarder, configuring the Kona Packet forwarder will be similar to how you configure the Semtech packet forwarder.
      The Kona Packet Forwarder uses the following file for configuration: /etc/default/config.json
      There are two ways to configure the above file:
      1. Through KonaFT
      2. Through SSH (ADVANCED USERS ONLY)
      KonaFT
      Ensure that the computer and gateway are on the same computer network. Then follow the steps below:
      1. Connect to the gateway.
      2. Select the configuration tab at the top.
      3. In the field, enter /etc/default/config.json and then click Read to see the contents of the configuration file.
      4. Configure the server address and the ports used to connect to the server as required.
      5. Finalize by selecting Write.
      6. Reboot the gateway by clicking Reboot.
      SSH (ADVANCED USERS ONLY)
      The steps to edit the file manually are as follows:
      1. SSH into the gateway.
      2. Use vi to edit the following file: /etc/default/config.json
      3. Reboot the packet forwarder with the following command: /etc/init.d/pkt_fwd restart