In this page we try to answer your gateway based questions. If you can't find an answer to your question below, please use the support link in the top navigation bar.


Contents



Standard


The basic details of a gateway

A gateway is basically an embedded computer with a radio front-end.

The operating system is usually some variant of Linux, and Linux can run any number of processes, but because of hardware limitations the radio front-end can be controlled by only one process at a time.

This means that only one packet forwarder can be run and access the radio front-end at a time and if multiple packet forwarders are running at the same time various issues are going to pop up.


For more gateway details and guides please check the User Resources section.

How to manage a LoRaWAN gateway

A LoRaWAN gateway is typically running a Linux distribution where the usual Linux commands will work.


  • Enabling autostart can be done with update-rc.d command: update-rc-d <program name> defaults
  • Disabling autostart can be done with: update-rc-d <program name> remove


For further explanation please refer to the documentation provided by the Gateway manufacturer.

How to uninstall the LORIOT Gateway Software

To uninstall the LORIOT Gateway Software for most of the gateway models, please delete the /opt/lrt directory and the /etc/init.d/loriot-gw file.


This can be done using the following commands:

rm -r /opt/lrt
rm /etc/init.d/loriot-gw
update-rc.d -f loriot-gw remove


A factory reset or a firmware upgrade will also remove all LORIOT related files.

TX Gain Adjustment

The TX Gain Adjustment field in the gateway detail allows you to reduce the output gain of the gateway in the case when a high-gain antenna is mounted to the gateway.

The TX Gain Adjustment should correspond to the gain that the antenna is adding.


The purpose of the adjustment is to be compliant with the radio regulations in your country.

Our software by default instructs the gateway to send at the maximum allowed power in the specific band, so by mounting a high-gain antenna, you would be most likely violating the radio regulations.

Remove the standard Semtech packet forwarder from boot

ps ax | grep lora # this should issue 1 line


If the second command shows more than one lines then you can remove the "start on boot" for the packet forwarder like this:


update-rc.d pkt-fwd remove


Reboot the gateway to test.

SSH tunnel port

The SSH tunnel only works if the port 22 is set as the SSH port. 

This is not changeable because it is hard coded in the binary.


For more details please refer to the SHH Tunnel Service page

SSH tunnel unauthorized error

LORIOT provides SSH tunnel command on the gateway page including all necessary parameters.

These parameters include the SSH token, and please be aware that the token can expire.

Within the user Interface ➜ Account  SSH-tokens page you can check the creation and expiry date. You can also create a new token or revoke an existing one.


Please note that the oldest token is used on the gateway page, even if it is already expired. It is advised to revoke the expired tokens.

Recommended Gateway time configuration

The certificate used by the server has a specified date range and the gateway's inner clock should be in this specified range. 

Also, the date (year, month, day) of the gateway should be match with the current date provided by the world clock.

How to access the gateway logs

A step by step guide can be found in the Accessing the Gateway Logs page.

If required as part of a LORIOT Support Ticket please send us the console output.

How to configure a gateway channel plan

Upon gateway registration, a default channel plan is selected:

If that is not suitable for your use-case you can change the channel plan using the following method: 


Within the gateway overview page, select the correct region for that gateway: 

Select the desired channel plan: 

Validate in the radio menu within the left menu bar that the desired frequencies are used by the gateway.

Restart the gateway to apply changes.

Selecting the right channel plan

There are two main criteria for picking the right channel plan:

  • Channel plan should use frequencies only which are permitted by the local government/regulator.
  • Gateway must be capable of working on the channel plans which are used by the channel plan.
Why are some features unavailable when using Semtech Packet Forwarder instead of LORIOT Gateway Software?

The Semtech Packet forwarder provides basic core feature for a LoRaWAN gateway to be able to forward uplink and downlink packets. 

LORIOT has significantly improved on this by creating the LORIOT Gateway Software which handles LoRa traffic and adds additional management and security features.


For example:

✔ SSH Tunnel

✔ Latency information

✔ Gateway system information

✔ Ability to ping gateway


More more details please check Software Advantages

All these feature need our integrated software running on the gateway side, which is not provided by Semtech Packet Forwarder. This is why when using Semtech Packet Forwarder, these features are not available. 

If your gateway model is not already integrated with the LORIOT Gateway Software please contact us and we can discuss adding support for this model. 

Accessing the gateway firmware via my LORIOT account

The gateway firmware (aka operating system) is independent from LORIOT and separate credentials (typically provided by the manufacturer) must be used to access the gateway and upgrade the OS

Please contact the specific gateway manufacturer for more details.

Best practices for gateway installation

For LORIOT software installation you can go to the software menu after registration of the gateway to get the necessary information.

In addition, there is a dedicated menu for LoRaWAN gateways in the LoRaWAN Gateway Guides page


Physical installation we recommend to visit the gateway vendor’s page and look for the installation guide.


Advanced


How to check the Multitech Conduit mCard version

Please SSH to the gateway and use the command to retrieve the version of the radio front-end:


sudo mts-io-sysfs show lora/hw-version

Raspberry Pi OpenSSL issue

Error:

loriot_rpi_spi: error while loading shared libraries: libssl.so.1.0.0



Solution:

sudo wget http://ftp.nl.debian.org/debian/pool/main/o/openssl/libssl1.0.0_1.0.1t-1+deb8u8_armhf.deb
sudo dpkg -i libssl1.0.0_1.0.1t-1+deb8u8_armhf.deb

Multitech Conduit mLinux/AEP version information

Hardware version:

mts-io-sysfs show product-id


LoRaWAN card version:

mts-io-sysfs show lora/hw-version


mLinux version:

cat /etc/mlinux-version


AEP version:

cat /etc/issue


Does my gateway use SPI or USB?

ls -la /dev/spi*

How to solve an issue with WiFi and the Multitech gateway

There are 2 ways to SSH into Multitech Wifi gateway:


  • Static IP from LAN 192.168.2.1
  • wlan0 assigned IP address of 192.168.1.6.


Running and installing LORIOT scripts from 192.168.2.1 port causing issues due that port doesn’t have internet access to connect to Professional Public Servers.

SSH in from wlan0 port into gateway using IP address of 192.168.1.6 and run loriot scripts, and all should be working.

Show FPGA version in KerOS

Run the following command:


cat /tmp/board_info.json


The parameters in "radio" section includes the version info for FPGA


"radio": {
 
                "DSP_1": "OK", 
 
                "DSP_2": "OK", 
 
                "Sx1301_1_cid": "1", 
 
                "Sx1301_1_ver": "103", 
 
                "Sx1301_2_cid": "1", 
 
                "Sx1301_2_ver": "103", 
 
                "fpga_cid": "0x00F144003074060E", 
 
                "fpga_swver": "58", 
 
                "spectrum_1_ver": "V2.d (0x23)", 
 
                "spectrum_2_ver": "V2.d (0x23)"
 
            }, 


Based on this information you can select the right FPGA version for your gateway.

Missing libssl.so.1.0.0 and libcrypto.so in the Kerlink OS

If you load the binary as the LORIOT Gateway binary only, as described in the Basic Installation section, the LORIOT Gateway Software does not execute and drops an error message:


./loriot-gw: error while loading shared libraries: libssl.so.1.0.0: cannot open shared object file: No such file or directory

For a workaround solution, please follow these steps:

SSH to the gateway and create a hardlink from /usr/lib/libssl.so.1.0.0 to /usr/lib/libssl.so.1.0.2 as the following: ln /usr/lib/libssl.so.1.0.2 /usr/lib/libssl.so.1.0.0

The same for libcrypto too from version 1.0.0 to version 1.0.2. in /usr/lib/libcrypto.so.1.0.2 /usr/lib/libcrypto.so.1.0.0

Kerlink IoT station blocking network traffic after factory reset

The Kerlink IoT station has a built in firewall which after a factory reset is activated with the default rules.

This rules blocks outgoing requests and new iptables rules must be added or the firewall can be fully disabled using the following method:


 In the /etc/sysconfig/network configuration file, change the “firewall” parameter to “no”.

Then restart the network script using the command /etc/rc.d/init.d/network restart


Disabling the firewall can be done with the following command: /etc/init.d/firewall stop

How to install the Cisco Gateway

To register the Cisco IXM gateway on a LORIOT Network Server please visit the page Cisco IXM LPWA.

Is the Mikrotik LoRaWAN gateway supported

The MikroTik LoRaWAN gateway is a closed system and users do not have root access to run custom applications, and therefore the LORIOT Gateway Software cannot be installed. 

However, LORIOT supports the pre-installed UDP semtech packet forwarder available on the gateway which can be used instead. 


To configure the gateway and provision it on the network server, please follow the guide in the Semtech Packet Forwarder page. 



6:32
The only solution is the preinstalled UDP SEMTECH pf