Installation of Basics Station
This guide will cover the installation of the LoRa Basics Station on Tektelic gateways as well as the transfer of the necessary certificates for connection to Third-Party network servers such as TTN, AWS IoT Core ect..
This article assumes the following pre-requisites have been met:
- Gateway is registered on an LoRaWAN Network Server - please refer to AWS IoT Core and TTN gateway onboard guide.
- Certificates are all generated and opened on a text editor.
- A working SSH connection to the gateway has been established.
Please SSH to the gateway and run the following commands. Lines that start with "#" are comments, not commands, do not paste these lines into the SSH console.
Step 1. Disable Tektelic LNS:
If you intend to connect to a Third-Party LoRaWAN network server using the LoRa Basics Station, the first step is to disable the gateway's connection to the Tektelic network server. To do so, please run the commands seen below from your gateway's command line:
sudo ls
# Input your admin password, then paste all the commands below:
cd /home/admin;
curl -k 74.3.134.37:32370//config/script_for_bstn.zip --output bstn.zip;
sudo unzip bstn.zip;
sudo rm bstn.zip;
sudo chmod a+x *.sh;sudo chmod a+x *.py;
sudo ./toggle_ns_oam.sh;
Once the shell script is running, please input "2" into the command line, and then paste the following into the command line:
ssl://lorawan-oam.tektelic.com:8883
Step 2. Install Tektelic BSTN
Before installing the LoRa Basics Station, please run the following command to find the BSP version running on your gateway:
system_version
Once you know the BSP version of your gateway, please run the following commands to authenticate your login as a superuser (sudo), so that you can run the scripts found in the appendix at the bottom of this page:
sudo ls
# Input your admin password
Step 3. Transfer Basic Station Certificates to the Gateway
After the installation of the LoRa Basics Station has been completed, please use the following shell script to transfer the certificates to the gateway. This shell script is downloaded when running the commands from the first step to disable the Tektelic LNS.
cd /home/admin
sudo ls
# # Input your sudo password here if needed :
cd /home/adminsudo ./movecerts.sh
# Follow the instructions to paste the certificates in the command line.
# Press enter for a new line.
# If the new line input is empty, the program deem the input for this file is done
sudo tektelic_reset
# tektelic_reset will reboot the gateway.
Note: In most terminal emulator, right click once is paste. If some steps failed, you can run the movecerts.sh again. This shell script should clean the interim files generated.
When some file is not needed, please press ENTER once to skip.
Appendix.1 Commands to Download Tektelic Basic Station Software
Kona Micro
BSP 4.0.X (4.0.2 and 4.0.5)
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/micro/40X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
BSP 5.0.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/micro/50X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
Kona Macro
BSP 5.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/macro/51X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
BSP 6.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/macro/61X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
Kona Mega
BSP 5.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/mega/50X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
BSP 6.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/mega/61X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
Kona Enterprise
BSP 2.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/enterprise/21X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
BSP3.1.X
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/enterprise/31X/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg
Universal BSP 7.1.12.1 for all Kona Gateway Models
sudo mv /etc/opkg/snmpManaged-feed.conf ~;
sudo bash -c "echo 'src/gz bsp http://74.3.134.37:32370/universal/71121/bsp' > /etc/opkg/snmpManaged-feed.conf";
sudo opkg update;
sudo opkg install tektelic-bstn;
sudo rm /etc/opkg/snmpManaged-feed.conf;
sudo mv ~/snmpManaged-feed.conf /etc/opkg